Como criar mensagens interativas

Use este guia para criar mensagens interativas na IAra via API.

Quando usar

Mensagens interativas ajudam a pessoa atendida a escolher opções, preencher dados ou abrir conteúdos sem depender de texto livre. Elas são úteis para triagem, qualificação, escolha de produto, formulário simples e sugestão de artigos.

Tipos comuns

• input_select: lista de opções.
• form: formulário com campos.
• cards: cartões com imagem, descrição e ações.
• article: lista de artigos ou links úteis.

Exemplo: opções

{
  "content": "Selecione uma das opções abaixo",
  "content_type": "input_select",
  "content_attributes": {
    "items": [
      { "title": "Falar com vendas", "value": "vendas" },
      { "title": "Falar com suporte", "value": "suporte" }
    ]
  },
  "private": false
}

Exemplo: formulário

{
  "content": "form",
  "content_type": "form",
  "content_attributes": {
    "items": [
      {
        "name": "email",
        "placeholder": "Digite seu e-mail",
        "type": "email",
        "label": "E-mail"
      },
      {
        "name": "observacao",
        "placeholder": "Descreva sua necessidade",
        "type": "text_area",
        "label": "Observação"
      },
      {
        "name": "segmento",
        "label": "Segmento",
        "type": "select",
        "options": [
          { "label": "Clínica", "value": "clinica" },
          { "label": "Imobiliária", "value": "imobiliaria" }
        ]
      }
    ]
  },
  "private": false
}

Exemplo: cards

{
  "content": "Veja as opções disponíveis",
  "content_type": "cards",
  "content_attributes": {
    "items": [
      {
        "media_url": "https://seudominio.com/imagem.png",
        "title": "Plano Profissional",
        "description": "Ideal para times que atendem em múltiplos canais.",
        "actions": [
          {
            "type": "link",
            "text": "Ver detalhes",
            "uri": "https://seudominio.com/planos"
          },
          {
            "type": "postback",
            "text": "Tenho interesse",
            "payload": "PLANO_PROFISSIONAL"
          }
        ]
      }
    ]
  },
  "private": false
}