Skip to main content
POST
/
api
/
create-message
curl -X POST https://chatbot.menuia.com/api/create-message \
  -H "Content-Type: application/json" \
  -d '{
    "appkey": "SUA_APPKEY_AQUI",
    "authkey": "SUA_AUTHKEY_AQUI",
    "to": "558189769960",
    "message": "Confira nossas ofertas exclusivas:",
    "footer_text": "Promoções válidas por tempo limitado",
    "cards": [
      {
        "image_url": "https://exemplo.com/produto1.jpg",
        "title": "Smartphone Premium",
        "subtitle": "Modelo 2026",
        "description": "Tela OLED, câmera de 200MP e bateria de longa duração.",
        "buttons": [
          {"type": "quickReplyButton", "displaytext": "Tenho interesse", "id": "opt-1"},
          {"type": "urlButton", "displaytext": "Abrir", "action": "https://exemplo.com/produto1"},
          {"type": "callButton", "displaytext": "Ligar", "action": "+5511999999999"}
        ]
      },
      {
        "image_url": "https://exemplo.com/produto2.jpg",
        "title": "Notebook Pro",
        "subtitle": "Edição Especial",
        "description": "Processador de última geração, ideal para trabalho e jogos.",
        "buttons": [
          {"type": "quickReplyButton", "displaytext": "Quero saber mais", "id": "opt-2"},
          {"type": "urlButton", "displaytext": "Ver detalhes", "action": "https://exemplo.com/produto2"}
        ]
      }
    ]
  }'
{
  "status": 200,
  "message": "Carrossel enviado com sucesso."
}

Documentation Index

Fetch the complete documentation index at: https://docs.menuia.com/llms.txt

Use this file to discover all available pages before exploring further.

Descrição

Este endpoint permite enviar uma mensagem em formato de carrossel com múltiplos cards. Cada card pode conter imagem, título, subtítulo, descrição e botões interativos (resposta rápida, link URL ou chamada telefônica).

Parâmetros

appkey
string
required
Chave de aplicação.
authkey
string
required
Chave de autenticação do usuário.
to
string
required
Número de telefone no formato internacional ou ID do grupo.
message
string
required
Texto do topo do carrossel, exibido antes dos cards.
Texto do rodapé exibido abaixo do carrossel.
cards
array
required
Array de cards que compõem o carrossel. Cada card possui:
  • image_url: URL da imagem do card
  • title: Título do card
  • subtitle: Subtítulo do card
  • description: Descrição ou legenda do card
  • buttons: Array de botões do card (ver tipos abaixo)

Tipos de Botões

quickReplyButton: Botão de resposta rápida. Quando clicado, envia o texto do botão como resposta. Requer displaytext e id.urlButton: Botão que abre um link externo. Requer displaytext e action com a URL.callButton: Botão que inicia uma chamada telefônica. Requer displaytext e action com o número de telefone.
curl -X POST https://chatbot.menuia.com/api/create-message \
  -H "Content-Type: application/json" \
  -d '{
    "appkey": "SUA_APPKEY_AQUI",
    "authkey": "SUA_AUTHKEY_AQUI",
    "to": "558189769960",
    "message": "Confira nossas ofertas exclusivas:",
    "footer_text": "Promoções válidas por tempo limitado",
    "cards": [
      {
        "image_url": "https://exemplo.com/produto1.jpg",
        "title": "Smartphone Premium",
        "subtitle": "Modelo 2026",
        "description": "Tela OLED, câmera de 200MP e bateria de longa duração.",
        "buttons": [
          {"type": "quickReplyButton", "displaytext": "Tenho interesse", "id": "opt-1"},
          {"type": "urlButton", "displaytext": "Abrir", "action": "https://exemplo.com/produto1"},
          {"type": "callButton", "displaytext": "Ligar", "action": "+5511999999999"}
        ]
      },
      {
        "image_url": "https://exemplo.com/produto2.jpg",
        "title": "Notebook Pro",
        "subtitle": "Edição Especial",
        "description": "Processador de última geração, ideal para trabalho e jogos.",
        "buttons": [
          {"type": "quickReplyButton", "displaytext": "Quero saber mais", "id": "opt-2"},
          {"type": "urlButton", "displaytext": "Ver detalhes", "action": "https://exemplo.com/produto2"}
        ]
      }
    ]
  }'
{
  "status": 200,
  "message": "Carrossel enviado com sucesso."
}