Para Desenvolvedores/Conteúdo Dinâmico

Conteúdo Dinâmico

Formato de resposta para envio de mensagens dinâmicas:

2026-08-07

Formato de resposta

Formato de resposta para envio de mensagens dinâmicas:

texto
{
  "version": "v1",
  "content": {
    "messages": [
      {
        "type": "text",
        "text": "simple text"
      },
      {
        ...Another messages
      }
    ],
    "actions": [  //optional
      {
        "action": "add_tag",
        "tag_name": "example tag"
      },
      {
        ...Another actions
      }
    ],
    "quick_replies": [ //optional
      {
        "type": "node",
        "caption": "Quick reply text",
        "target": "My Content"
      },
      {
        ...Another quick replies
      }
    ]
  }
}

Versão atual da API de bloco dinâmico v1O bloco dinâmico tem um limite para ter no máximo 10 mensagens em messagesbloco, 11 respostas rápidas e 5 ações. As propriedades "buttons", "actions", "quick_replies"são opcionais.

Reply threading (reply_to_mid)

Em canais que suportam resposta a uma mensagem específica (por exemplo, Facebook, WhatsApp e TikTok), é possível incluir o campo reply_to_mid em uma mensagem para que ela apareça como resposta direta a uma mensagem anterior específica, em vez de uma mensagem solta no fluxo da conversa.

texto
{
  "type": "text",
  "text": "Aqui está a resposta ao que você perguntou",
  "reply_to_mid": "ID_DA_MENSAGEM_ORIGINAL"
}

Tipos de botão suportados

Além do botão do tipo "node" (que direciona para um bloco/nó do fluxo), o bloco dinâmico também suporta:

  • URL — abre um link externo.
  • Call (telefone) — inicia uma ligação para um número especificado.

Formatos de imagem

Imagens enviadas via bloco dinâmico podem estar nos formatos JPG, PNG e GIF. Em canais que suportam múltiplas imagens por mensagem (como Facebook), é possível enviar mais de uma imagem na mesma mensagem dinâmica.