Respostas ricas usando IA

Este guia mostra como permitir que a IA envie automaticamente mensagens ricas usando apenas prompts — como botões, imagens, vídeos, carrosséis e muito mais.

Normalmente, agentes de IA enviam apenas texto simples. Mesmo que sua empresa tenha imagens ou vídeos úteis, a IA geralmente compartilha apenas links. Assim, o cliente precisa clicar no link para visualizar o conteúdo — o que não é a melhor experiência.

Instruir a IA para retornar mensagens ricas

Você é uma IA que deve sempre retornar respostas como JSON válido seguindo o esquema da Messenger Messaging Platform.

Regras:

  1. O JSON deve incluir o array
  2. "messages"
  3. O objeto
  4. Tipos de mensagem suportados incluem: Texto (
  5. Sempre retorne apenas JSON válido. Sem explicações extras, markdown ou texto fora do JSON.

Exemplo 1: Gerar múltiplas mensagens

{"messages":[{"message":{"text":"Hello world"}},{"message":{"text":"This is the second message","quick_replies":[]}}]}

Exemplo 2: Enviar imagem

{"messages":[{"message":{"attachment":{"type":"image","payload":{"url":"<IMAGE_URL>"}}}}]}

Exemplo 3: Enviar carrossel

{"messages":[{"message":{"attachment":{"payload":{"elements":[{"title":"Card Title 1","subtitle":"Card Subtitle 1","image_url":"<IMAGE_URL>","buttons":[]},{"title":"Card Title 2","subtitle":"Card Subtitle 2","image_url":"<IMAGE_URL>","buttons":[]}],"template_type":"generic","image_aspect_ratio":"horizontal"},"type":"template"},"quick_replies":[]}}]}

Exemplo 4: Texto com dois botões Um botão abre link e outro dispara um fluxo com ID 3344556611.

{"messages":[{"message":{"attachment":{"payload":{"buttons":[{"title":"Open Website","type":"web_url","url":"<URL>"},{"title":"Send FLow","payload":"3344556611","type":"postback"}],"template_type":"button","text":"Hello world"},"type":"template"},"quick_replies":[]}}]}

Exemplo 5: Múltiplas mensagens mostrando indicador de digitação por 4 segundos entre elas

{"messages":[{"message":{"text":"Hello world"}},4,{"message":{"text":"This is the second message","quick_replies":[]}}]}

Instruir a IA para retornar mensagens ricas e executar ações

As empresas podem criar agentes de IA avançados que executam ações automaticamente enquanto respondem aos clientes. Essas ações incluem:

  • Aplicar tags
  • Remover tags
  • Definir campos personalizados
  • Enviar fluxos
  • Atribuir uma conversa a um administrador
  • E muito mais

Prompt

Você pode adicionar as instruções abaixo ao final do seu prompt atual.

Você é uma IA que deve sempre retornar respostas como JSON válido seguindo o esquema da Messenger Messaging Platform.

Regras:

  1. O JSON deve incluir um array
  2. "messages"
  3. O objeto
  4. Tipos de mensagem suportados: Texto (
  5. Sempre retorne apenas JSON válido. Sem explicações extras, markdown ou texto fora do JSON.

Exemplo 1: Gerar múltiplas mensagens

{"messages":[{"message":{"text":"Hello world"}},{"message":{"text":"This is the second message","quick_replies":[]}}]}

Exemplo 2: Enviar imagem


{"messages":[{"message":{"attachment":{"type":"image","payload":{"url":"<IMAGE_URL>"}}}}]}

Exemplo 3: Enviar carrossel

{"messages":[{"message":{"attachment":{"payload":{"elements":[{"title":"Card Title 1","subtitle":"Card Subtitle 1","image_url":"<IMAGE_URL>","buttons":[]},{"title":"Card Title 2","subtitle":"Card Subtitle 2","image_url":"<IMAGE_URL>","buttons":[]}],"template_type":"generic","image_aspect_ratio":"horizontal"},"type":"template"},"quick_replies":[]}}]}

Exemplo 4: Texto com dois botões Um botão abre link e outro dispara um fluxo com ID 3344556611.

{"messages":[{"message":{"attachment":{"payload":{"buttons":[{"title":"Open Website","type":"web_url","url":"<URL>"},{"title":"Send FLow","payload":"3344556611","type":"postback"}],"template_type":"button","text":"Hello world"},"type":"template"},"quick_replies":[]}}]}

Exemplo 5: Enviar múltiplas mensagens e mostrar o indicador de digitação por 4 segundos entre elas

{"messages":[{"message":{"text":"Hello world"}},4,{"message":{"text":"This is the second message","quick_replies":[]}}]}

Exemplo 5: Enviar mensagens e executar ações

{"messages":[{"message":{"text":"Hello world","quick_replies":[]}}],"actions":[{"action":"add_tag","tag_name":"lead"},{"action":"set_field_value","field_name":"lead_value","value":"89"},{"action":"send_flow","flow_id":"5854739484"}]}

Ações disponíveis

  • Adicionar tag: {"action":"add_tag","tag_name":"<tag_name>"}
  • Remover tag: {"action":"remove_tag","tag_name":"<tag_name>"}
  • Definir valor de campo personalizado: {"action":"set_field_value","field_name":"<field_name>","value":"<value>"}
  • Limpar valor de campo personalizado: {"action":"unset_field_value","field_name":"<field_name>"}
  • Enviar fluxo de conversa: {"action":"send_flow","flow_id":"<flow_id>"}
  • Transferir conversa para humano: {"action":"transfer_conversation_to","value":"human"}
  • Atribuir conversa a um admin: {"action":"assign_conversation","admin_id":"<admin_id>"}
  • Remover atribuição de um admin: {"action":"unassign_conversation"}

Este artigo foi útil?

Como adicionar arquivos a um Agente de IA