Botões e mídia

Além de texto, o agente envia botões de resposta, um botão de link e os arquivos dos seus materiais. Do outro lado, ele entende o áudio, a imagem e o PDF que o contato manda. Esta página mostra o que vale em cada canal e os limites de cada recurso.

#Botões de resposta

O agente pode terminar a mensagem com botões, para o contato escolher com um toque. Quando o contato toca num botão, o texto do botão chega como a resposta dele e a conversa continua.

• Até 3 botões por mensagem.
• Até 20 caracteres por botão. O que passar disso é cortado.
• Botões repetidos são enviados uma vez só.

Não existe um campo para cadastrar os botões. Você pede nas instruções:

• «Quando o contato perguntar os planos, mande os botões «Mensal», «Anual» e «Tenho dúvida».»
• «Use botões só para escolhas simples, como sim ou não.»

#Como os botões aparecem em cada canal

#Botão de link

O agente pode enviar um botão que abre uma página: cadastro, pagamento, agenda, site.

• Um botão de link por mensagem.
• O texto do botão tem até 20 caracteres.
• O endereço precisa começar com http:// ou https://.

Exemplo de instrução:

• «Quando o contato quiser comprar, mande um botão de link com o texto «Comprar agora» e o endereço https://exemplo.com/checkout.»

#Link com dados do contato

O endereço pode ter variáveis, como https://exemplo.com/cadastro?tel={{phone}}. O Leadz troca a variável pelo dado do contato antes de enviar. O telefone e o e-mail do contato não são enviados ao provedor de IA: a troca acontece depois que a IA responde.

#Link e botões na mesma mensagem

Cabem até 3 botões no total. Com um botão de link, sobram 2 botões de resposta. Cada canal mostra de um jeito:

#Resposta em várias mensagens

O agente pode dividir a resposta em mensagens curtas e seguidas, até 10 por resposta. Cada uma sai com o aviso de «digitando», nos canais que mostram esse aviso. Os botões e o link vão sempre na última mensagem.

#Arquivos que o agente envia

O agente envia os arquivos cadastrados em Material de Conhecimento: imagem, vídeo e documento. O arquivo chega logo depois do texto. O envio funciona no WhatsApp (API oficial e não oficial), no Instagram, no Messenger e no Chatbot do site.

O agente não grava áudio e não envia arquivo que não esteja nos materiais. Veja Materiais e base de conhecimento.

#O que o agente entende do que o contato envia

O agente lê o que o contato mandou desde a última resposta: até 3 arquivos por vez, com até 16 MB cada.

O que o agente consegue ler depende do provedor e do modelo. A tabela de quem lê imagem e como ligar a transcrição de áudio está em Provedores e modelos.

A leitura vale no WhatsApp, no Instagram, no Messenger e no Chatbot do site.

#Formatação do texto

Peça ao agente texto simples, sem títulos, tabelas ou listas com símbolos. WhatsApp, Instagram e Messenger mostram esses símbolos crus. Um link escrito no formato [texto](endereço) é convertido para «texto: endereço» antes do envio.

#Problemas comuns

O agente escreveu «[Link de cadastro]» no texto, mas não veio link

O endereço não está nas instruções, ou a regra não pediu um botão de link. Escreva o endereço completo nas instruções e peça: «mande um botão de link com o texto … e o endereço …».

O link chegou sem o dado do contato

O contato não tem aquele dado salvo na ficha, então a variável ficou vazia. Defina um valor reserva na própria variável, assim: {{phone|sem telefone}}.

Os botões chegaram como lista numerada

No WhatsApp API oficial isso acontece em dois casos: o texto passou de 1.024 caracteres, ou a mensagem tem um botão de link junto. Peça respostas mais curtas ou separe o link dos botões.

O agente ignora a imagem que o contato manda

O modelo escolhido não lê imagens. Troque o modelo do agente por um que leia. Veja a tabela em Provedores e modelos.

O agente não entende áudio

Falta um token compatível com transcrição. Em Tokens de IA, confira o campo Chave usada para transcrição de áudio.

#Veja também

• Provedores e modelos
• Materiais e base de conhecimento
• Testar o agente