Como criar mensagens interativas?

Última atualização em May 21, 2026

O Wootdesk permite criar mensagens interativas como:

  • Seleções de opções

  • Formulários

  • Cards

  • Artigos

diretamente no widget de chat do site utilizando as APIs.

Essas mensagens podem ser criadas através da API de Nova Mensagem (New Message API).


Exemplos de Payloads

Utilize os exemplos abaixo como base para criar diferentes tipos de mensagens interativas.


1. Mensagem com opções

Permite que o usuário selecione uma opção da lista.

{
  "content": "Selecione uma das opções abaixo",
  "content_type": "input_select",
  "content_attributes": {
    "items": [
      {
        "title": "Opção 1",
        "value": "Opcao 1"
      },
      {
        "title": "Opção 2",
        "value": "Opcao 2"
      }
    ]
  },
  "private": false
}

2. Formulário

Permite coletar dados do usuário diretamente no chat.

{
  "content": "formulario",
  "content_type": "form",
  "content_attributes": {
    "items": [
      {
        "name": "email",
        "placeholder": "Digite seu e-mail",
        "type": "email",
        "label": "E-mail",
        "default": "[email protected]"
      },
      {
        "name": "mensagem",
        "placeholder": "Digite sua mensagem",
        "type": "text_area",
        "label": "Mensagem",
        "default": "Texto de exemplo"
      },
      {
        "name": "nome",
        "placeholder": "Digite seu nome",
        "type": "text",
        "label": "Nome",
        "default": "João"
      },
      {
        "name": "produto",
        "label": "Selecione um produto",
        "type": "select",
        "options": [
          {
            "label": "🌯 Burrito",
            "value": "Burrito"
          },
          {
            "label": "🍝 Pasta",
            "value": "Pasta"
          }
        ]
      }
    ]
  },
  "private": false
}

3. Cards

Permite criar cards com imagem, descrição e botões de ação.

{
  "content": "mensagem card",
  "content_type": "cards",
  "content_attributes": {
    "items": [
      {
        "media_url": "https://example.com/produto.jpg",
        "title": "Tênis Nike 2.0",
        "description": "Tênis ideal para corrida",
        "actions": [
          {
            "type": "link",
            "text": "Ver mais",
            "uri": "https://google.com"
          },
          {
            "type": "postback",
            "text": "Adicionar ao carrinho",
            "payload": "ITEM_SELECTED"
          }
        ]
      }
    ]
  },
  "private": false
}

4. Artigos

Permite enviar artigos e conteúdos úteis diretamente no chat.

{
  "content": "artigos",
  "content_type": "article",
  "content_attributes": {
    "items": [
      {
        "title": "Guia inicial da API",
        "description": "Documentação introdutória da API",
        "link": "https://google.com"
      },
      {
        "title": "Documentação para desenvolvedores",
        "description": "Guias e boas práticas de desenvolvimento",
        "link": "https://google.com"
      }
    ]
  },
  "private": false
}

Tipos de mensagens suportadas

Tipo Descrição
input_select Lista de opções
form Formulários interativos
cards Cards com mídia e ações
article Lista de artigos/conteúdo

Observações importantes

  • As mensagens interativas funcionam no widget do site.

  • Os payloads devem ser enviados utilizando a API de mensagens do Wootdesk.

  • Você pode combinar essas mensagens com bots, automações e APIs externas para criar fluxos avançados de atendimento.