Início Funcionalidades Avançadas Como criar mensagens interativas

Como criar mensagens interativas

Última atualização em Apr 18, 2025

A Akece permite o envio de mensagens interativas no widget de atendimento do site, como listas de opções, formulários, cartões com imagem e artigos recomendados. Essas mensagens podem ser criadas por meio da API de criação de mensagens (New Message API).

Esses formatos ajudam a engajar melhor seus clientes, coletar informações com mais agilidade e oferecer experiências mais dinâmicas.

Modelos de payload

A seguir, veja exemplos de payloads que podem ser utilizados para criar cada tipo de mensagem interativa via API.

1. Lista de opções

Permite que o cliente selecione uma opção entre as disponíveis.

{
  "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 informações personalizadas como e-mail, texto, seleção de itens, entre outros.

{
  "content": "form",
  "content_type": "form",
  "content_attributes": {
    "items": [
      {
        "name": "email",
        "placeholder": "Digite seu e-mail",
        "type": "email",
        "label": "E-mail",
        "default": "[email protected]"
      },
      {
        "name": "mensagem",
        "placeholder": "Escreva sua mensagem",
        "type": "text_area",
        "label": "Mensagem",
        "default": ""
      },
      {
        "name": "nome",
        "placeholder": "Digite seu nome",
        "type": "text",
        "label": "Nome",
        "default": ""
      },
      {
        "name": "produto",
        "label": "Produto de interesse",
        "type": "select",
        "options": [
          { "label": "🌯 Burrito", "value": "burrito" },
          { "label": "🍝 Macarrão", "value": "macarrao" }
        ]
      }
    ]
  },
  "private": false
}

3. Cartões

Exibe uma imagem com título, descrição e botões de ação.

{
  "content": "card message",
  "content_type": "cards",
  "content_attributes": {
    "items": [
      {
        "media_url": "https://link-da-imagem.jpg",
        "title": "Tênis Nike 2.0",
        "description": "Modelo ideal para corrida e conforto.",
        "actions": [
          {
            "type": "link",
            "text": "Ver mais",
            "uri": "https://www.exemplo.com"
          },
          {
            "type": "postback",
            "text": "Adicionar ao carrinho",
            "payload": "ITEM_SELECIONADO"
          }
        ]
      }
    ]
  },
  "private": false
}

4. Artigos recomendados

Apresenta uma lista de artigos com título, descrição e link para leitura.

{
  "content": "articles",
  "content_type": "article",
  "content_attributes": {
    "items": [
      {
        "title": "Guia de integração com API",
        "description": "Aprenda como começar a usar nossa API.",
        "link": "https://www.exemplo.com/guia-api"
      },
      {
        "title": "Documentação técnica",
        "description": "Leia as diretrizes de desenvolvimento e integração.",
        "link": "https://www.exemplo.com/docs"
      }
    ]
  },
  "private": false
}

Se precisar de ajuda para criar mensagens interativas na sua conta, fale com o nosso time:
📩 [email protected] | 📱 @akece.ai