Como trabalhar com botões

O Instagram não suporta o envio de botões inline e de resposta ao mesmo tempo

Teclado (resposta)

O Instagram suporta até 11 botões de resposta. Os botões só podem ser organizados em uma linha

Exemplo:

Resultado:

No texto (inline)

O Instagram suporta no máximo 3 botões inline

Os botões podem direcionar para recursos de terceiros. Visualmente, esses botões são idênticos.

Para instruções sobre como configurar botões, consulte a seção Botões.

Como trabalhar com anexos

Você pode enviar anexos na mensagem. Para mais informações sobre quais anexos e como adicioná-los, consulte a seção Enviando anexos na documentação.

Você pode enviar anexos para um bloco como arquivo ou fornecendo um link para o arquivo.

Os arquivos de vídeo enviados não devem exceder 20 MB, enquanto os arquivos de áudio e imagem devem ter no máximo 5 MB.

Requisitos de anexo:

Tipo de arquivo de mídia Formato suportado Tamanho máximo
Áudio M4A 5 MB
Imagem JPEG, PNG 5 MB
Vídeo MP4 20 MB

NÃO é recomendado usar o formato MP4 para anexos de áudio. Além disso, nenhum áudio será enviado no formato MP3.

Como criar um carrossel

O carrossel pode conter de 2 a 10 cartões (slides).

Vamos usar um carrossel de 3 cartões como exemplo. Para criar os cartões, você precisa inserir o seguinte no campo Calculadora:

p = [{"title":"TÍTULO", "description": "DESCRIÇÃO DA IMAGEM 1", "image": "LINK PARA A IMAGEM 1", "buttons":[{"text":"TEXTO DO BOTÃO 1"}]},{"title":"TÍTULO", "description": "DESCRIÇÃO DO CARTÃO 2", "image": "LINK PARA A IMAGEM 2", "buttons":[{"text":"TEXTO DO BOTÃO 2"}]}, {"title":"TÍTULO", "description": "DESCRIÇÃO DO CARTÃO 3", "image": " LINK PARA A IMAGEM 3", "buttons":[{"text":"TEXTO DO BOTÃO 3"}]}]

r = send_carousel(p, '')

Copie o link:

O resultado:

Observe: a expressão r = send_carousel(p, '') deve começar em uma nova linha na Calculadora.

Isso significa que você precisa atribuir um array contendo título, descrição, imagem e botões a uma variável p (nomeie a variável de forma diferente, se desejar). Em seguida, use esta variável no método send_carousel(p, "").

Isso deixa #{None} no campo "Resposta".

Você pode adicionar links aos botões nos cartões do carrossel. Quando um usuário clicar no botão, será direcionado ao link.

Para adicionar um link a um botão no cartão, inclua-o no array:

p = [{"title":"título", "description": "DESCRIÇÃO DO CARTÃO 1", "image": "LINK PARA A IMAGEM 1", "buttons":[{"text":"TEXTO DO BOTÃO 1", "url":"LINK PARA O BOTÃO" }]}]

Outro parâmetro opcional, payload, foi adicionado aos botões do cartão do carrossel. Ele não é exibido para o cliente, mas permite analisar a escolha do cliente.

Como os cartões do carrossel geralmente exigem botões com texto idêntico, um parâmetro adicional payload foi introduzido. Este parâmetro não é visível para o cliente, mas permite analisar a seleção dele.

Preste atenção ao seu uso adequado:

p = [{"title":"título", "description": "DESCRIÇÃO DO CARTÃO 1", "image": " 1", "buttons":[{"text":"TEXTO DO BOTÃO 1","payload":"1"}]},{"title":"título", "description": "DESCRIÇÃO DO CARTÃO 2", "image": "LINK PARA A IMAGEM 2", "buttons":[{"text":"TEXTO DO BOTÃO 1","payload":"2"}]}, {"title":"título", "description": "DESCRIÇÃO DO CARTÃO 3", "image": "LINK PARA A IMAGEM 3", "buttons":[{"text":"TEXTO DO BOTÃO 1"}]}]

O parâmetro payload pode ser omitido, conforme mostrado na Figura acima.

Como definir frases introdutórias

As frases introdutórias permitem que uma pessoa inicie um chat com uma empresa usando uma lista de solicitações frequentes. Você pode configurar até quatro solicitações.

Para configurar frases introdutórias, você precisa ativar um controle deslizante na conta do Instagram conectada, na seção “Canais”.

Após clicar neste controle deslizante, uma janela pop-up aparece onde você pode definir as frases introdutórias necessárias.

Em seguida, siga estas etapas:

  1. Configure respostas para frases específicas no seu funil.
  2. Coloque os blocos necessários no estado "Iniciar".
  3. Insira o texto da frase introdutória no gatilho.

Observe!

As frases introdutórias aparecem para usuários que não entraram em contato anteriormente com sua conta do Instagram (ou se todo o histórico de chat anterior foi excluído).

Configurar uma resposta por palavra-chave no Direct

Para responder a clientes em Mensagens Diretas com base em palavras-chave, você pode usar um bloco com um Gatilho (blocos Iniciar e Gatilho) e inserir as palavras às quais deseja que seu bot responda no campo Gatilho:

A escolha de uma correspondência é baseada na presença de palavras-chave ou em uma correspondência completa (opções recomendadas).

No campo "Texto da mensagem", insira a resposta do bot que o usuário receberá. Você também pode adicionar anexos, botões e links.

Como verificar se um usuário está inscrito na sua conta

Existem dois métodos para verificar o status de inscrição:

1. Verificando a inscrição usando a calculadora

result = check_insta_subscription()

result é o nome da variável onde o resultado da verificação será armazenado (você pode renomeá-lo se necessário).

A função retorna:

  • True se o usuário estiver inscrito.
  • False se o usuário não estiver inscrito.

A verificação deve ser realizada no campo "Variável", tanto na seta quanto no bloco.

  • result == True – uma expressão no campo "Variável" se o cliente estiver inscrito na conta.
  • result == False – uma expressão se o cliente não estiver inscrito.

Você também pode usar outras expressões de comparação, por exemplo:
result != False (resultado não é igual a False, significando que o usuário está inscrito na conta).

  1. Dados da verificação do cartão do cliente

Quando um usuário interage com o bot, as variáveis follow e followers são exibidas e verificadas no cartão do cliente (na subseção Variáveis do Cliente).

Variável follow – verifica o status de inscrição. Assume o valor True se o cliente estiver inscrito na conta, False se não estiver inscrito e None se a conta do cliente estiver fechada.

verified – indica se o usuário tem uma conta verificada (selo azul). É True se verificado e False se não.

followers – mostra o número de inscritos/seguidores que o cliente tem.

Para verificar o status de inscrição ou restringir o progresso do funil, você pode usar a variável follow em blocos de condição ou conectores de seta no campo "Variável".

Exemplo:

No campo Gatilho, insira qualquer palavra que iniciará seu funil.

Na variável para comparação, escreva:
follow == True
OU
follow != False

  • No primeiro caso, você verifica se a pessoa está inscrita na sua conta.
  • No segundo caso, você verifica se a pessoa não está inscrita na sua conta.

Observe que os status True e False devem estar em maiúsculas. Caso contrário, a verificação não funcionará corretamente.

Para entregar mensagens diferentes com base no status de inscrição, você precisa criar dois blocos com condições opostas. Se preferir uma abordagem menos poluída, recomendamos definir as condições nas conexões (setas).

Gatilhos nas conexões:

Insira o gatilho na linha "Variável" da seta:
follow == True ou follow != False

Se a condição do gatilho for atendida, o cliente prossegue no funil.

Se o cliente não estiver inscrito, ele vai para o bloco onde as condições de verificação não são atendidas (follow == False ou follow != True).

Se você quiser que a verificação seja dinâmica, recomendamos adicionar um botão—por exemplo, "Eu me inscrevi"—para que a verificação possa ser realizada e a pessoa possa passar para a próxima etapa.

Atenção

NÃO recomendamos definir um temporizador sem um botão em uma seta fechada, pois a pessoa receberá mensagens continuamente, esgotando rapidamente seu limite de mensagens.