Skip to content
Para o administrador da conta › Para quem integra
Para quem integra

Conversational API (Meta Cloud)

Enviar pela Cloud API oficial dentro da janela de 24 horas — texto, mídia, botões e cardápio.

3 min de vídeo 11 imagens Painel do administrador
Aula gravada na plataforma real. O cursor, as legendas e o destaque existem só no vídeo.

A Conversational API envia pela Cloud API oficial da Meta. É a irmã da REST API de QR, para quem tem número oficial — e obedece a regra que rege toda a Cloud API: a janela de 24 horas.

Tela da Conversational API
Desenvolvedor › Conversational API.
Conta Meta
Exige uma conta Meta/Cloud conectada.

A janela de 24 horas

Janela de 24 horas
A regra que separa esta API da Template API.
  • O cliente falou com você nas últimas 24h → você responde o que quiser, por esta API.
  • Passaram-se mais de 24h → só sai template aprovado, pela Template API.
A regra é da MetaA Heyoo não escolhe isso e não tem como contornar. Tentar enviar texto livre fora da janela devolve erro da própria Meta — por isso o conector MCP tem uma ferramenta só para checar se a janela está aberta.

Autenticação

Chave de API
A mesma chave de API da sua conta.
Base URL
Base URL, com botão de copiar.

O que dá para enviar

Tipos suportados
Os tipos aceitos pela Cloud API.
Mensagem com botões
Botões: até três opções para o cliente tocar.
Botão sempre rende mais que textoPedir responda 1, 2 ou 3 gera erro de digitação e conversa perdida. Botão e cardápio eliminam isso — e a resposta chega padronizada, o que facilita automatizar o que vem depois.

O caminho artesanal

Modo artesanal
Enviar o messageObject cru, como a Meta espera.

Quem já conhece a documentação da Meta pode montar o objeto da mensagem por conta própria: a Heyoo apenas repassa. É a saída quando a Meta lança um recurso novo antes de a tela ganhar um botão para ele.

Testar antes de programar

Testar envio
O envio de teste, direto da tela.
Teste na tela
O erro da Meta, quando houver, aparece aqui.
  1. Conecte a conta Meta/Cloud em Canais.
  2. Abra Desenvolvedor › Conversational API.
  3. Copie a Base URL e a chave de API.
  4. Escolha o tipo de mensagem e preencha o exemplo.
  5. Use Testar para conferir antes de escrever código.
  6. Leve o exemplo pronto para o seu sistema.