EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Messenger Send API: envio de mensagens de uma Página do Facebook

Uma Página do Facebook envia mensagens do Messenger com POST /{page-id}/messages e um token de acesso da Página: o objeto recipient traz o ID de escopo da Página (PSID) da pessoa, messaging_type é RESPONSE ou UPDATE dentro da janela de atendimento padrão ou MESSAGE_TAG depois dela, e message traz texto ou um anexo, como imagem, áudio, vídeo ou arquivo. A Meta responde com o recipient_id e um message_id.

A easyCoexistence responde DMs no Messenger com send_social_dm a partir do Claude, do ChatGPT ou do seu próprio código, dentro da janela de atendimento de 24 horas, como texto; mídia, quick_replies e templates não são cobertos.

300 per second

Chamadas da Send API que um app pode fazer por Página para mensagens com texto, links, reações e stickers.

10 per second

Chamadas da Send API que um app pode fazer por Página para mensagens que contêm áudio ou vídeo.

25 MB

Maior ativo que a Messenger Platform salva para reutilização; uma imagem enviada por URL tem limite de 8 MB.

30 images

Maior número de imagens que uma mensagem pode levar no array attachments, o único tipo de mídia permitido ali.

90 days

Por quanto tempo um attachment_id salvo continua válido antes de a mídia precisar ser enviada de novo.

O que uma requisição da Send API contém?

A Meta lista seis componentes que um envio precisa ter: o ID da Página que envia, o ID da pessoa que recebe, um token de acesso da Página, a permissão da pessoa, o tipo da mensagem e o conteúdo. A requisição é um POST em JSON para /{page-id}/messages, e uma resposta a alguém que acabou de escrever tem esta forma:

A text reply, and Meta's answer
POST /{page-id}/messages
{
  "recipient": { "id": "<PSID>" },
  "messaging_type": "RESPONSE",
  "message": { "text": "Your order ships tomorrow." }
}

{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }

Qual ID vai em recipient?

Normalmente o ID de escopo da Página, ou PSID, que a Meta atribui a uma pessoa na primeira vez que ela envia mensagem à Página; ele chega como sender.id no webhook de mensagens. O objeto recipient aceita outros tipos de ID para casos específicos:

  • id: o PSID, único para aquela pessoa e aquela Página.
  • user_ref: para quem usou um plugin ou um botão de postback para enviar mensagem à Página.
  • comment_id ou post_id: para uma resposta privada a um comentário ou a uma publicação de visitante.
  • IDs do Facebook Login têm escopo de app e não funcionam na Messenger Platform.

Qual messaging_type uma mensagem deve usar?

O tipo informa à Meta por que a mensagem está sendo enviada e decide quando o envio é permitido. A referência de mensagens da Página na Meta lista quatro valores:

  • RESPONSE: uma resposta a uma mensagem que a Página recebeu, promocional ou não, dentro da janela de atendimento padrão.
  • UPDATE: uma mensagem que a Página envia por iniciativa própria, promocional ou não, também dentro da janela.
  • MESSAGE_TAG: uma mensagem não promocional enviada depois da janela, com uma tag que corresponde a um caso de uso aprovado.
  • UTILITY: uma mensagem utilitária criada a partir de um template aprovado, como uma atualização de pedido ou de agendamento.

O que uma mensagem pode levar?

Texto, ou um objeto de anexo com um tipo e um payload: anexos de imagem, áudio, vídeo e arquivo apontam para uma URL ou para um attachment_id salvo, e anexos de template levam mensagens estruturadas com botões. O mesmo endpoint também aceita estes campos:

  • attachments: um array de até 30 imagens enviadas em uma só mensagem.
  • reply_to com um mid: uma resposta a uma mensagem anterior específica, da pessoa ou da Página.
  • quick_replies: até 13 botões acima do campo de escrita, cada título com até 20 caracteres.
  • sender_action: um indicador de digitando, uma marca de visto ou uma reação, enviado em uma requisição separada da própria mensagem.
  • notification_type: REGULAR por padrão, ou SILENT_PUSH ou NO_PUSH.

Qual é o tamanho máximo dos anexos?

O guia da Meta para salvar ativos define os limites da mídia que a Messenger Platform busca e mantém: ativos de até 25 MB, imagens de até 8 MB quando enviadas por URL, áudio enviado com Content-Type de áudio e vídeo buscado em até 75 segundos. Definir is_reusable como true retorna um attachment_id que só a Página que o enviou pode reutilizar, por 90 dias, e POST /{page-id}/message_attachments envia a mídia com antecedência.

Quais são os limites de taxa da Send API?

A Meta os conta por Página e por tipo de conteúdo. A referência de mensagens da Página lista o 613, Calls to this api have exceeded the rate limit, entre os erros de envio, então desacelere em vez de repetir de imediato quando ele aparecer:

  • 300 chamadas por segundo por Página para mensagens com texto, links, reações e stickers.
  • 10 chamadas por segundo por Página para mensagens com áudio ou vídeo.
  • Muitas mensagens para uma única conversa podem sofrer limite de taxa por conta própria.
  • Chamadas da Messenger API no total: 200 vezes o número de usuários engajados, em um período móvel de 24 horas.
  • Acima de 40 mensagens por segundo, a caixa de entrada da Página deixa de mostrar novas mensagens e a Página não consegue enviar até o volume cair.

Quais erros a Send API retorna?

A tabela de erros do Messenger da Meta associa cada código a um subcódigo que indica a causa. Estes são os que uma Página encontra com mais frequência ao enviar:

  • 10 com 2018278 ou 2534022: esta mensagem foi enviada fora da janela permitida.
  • 10 com 2018300: outro app controla a conversa.
  • 100: parâmetro inválido, como um ID de destinatário errado; o subcódigo 2018001 traz a mensagem No matching user found.
  • 551: a pessoa não está disponível, talvez por ter bloqueado a Página ou desativado a conta; 200 com 1545041 traz a mensagem This person isn't available right now.
  • 200 com 2018028: o app não pode enviar mensagens a pessoas fora de seus papéis até que pages_messaging seja revisado e o app esteja publicado.
  • 10904: a Página tem as mensagens desativadas nas configurações.

Como a easyCoexistence envia por ela?

send_social_dm recebe o account_id, o recipient_id da pessoa, que é o sender.id em um evento de mensagens encaminhado, e o texto, e os publica em /{page-id}/messages com messaging_type RESPONSE. O resultado é a resposta da Meta com o message_id, e um envio recusado volta com o código de erro e a mensagem da Meta. Mídia, quick_replies, templates e sender_action não estão entre as ferramentas: send_social_dm envia texto.

Erros comuns

  • Enviar um indicador de digitação junto com a mensagem. A Meta quer sender_action sozinho com o destinatário, e texto ou templates em uma requisição separada.
  • Disparar uma rajada para uma pessoa. A Meta pode limitar a taxa de uma única conversa por conta própria, à parte das 300 chamadas por segundo da Página.
  • Enviar áudio ou vídeo no ritmo de texto. Mensagens com áudio ou vídeo ficam limitadas a 10 chamadas por segundo por Página.
  • Reutilizar um attachment_id com mais de 90 dias. Os IDs de anexos salvos expiram, então envie a mídia de novo para obter um novo.
Fazendo isso com o EasyCoexistence

As automações respondem sozinhas a novas mensagens com um texto fixo ou uma resposta da IA. De US$ 9 até US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

A Messenger Send API é gratuita?

Sim, para mensagens padrão. A visão geral da Meta chama a Messenger Platform de gratuita para uso, então uma Página que responde a pessoas que lhe escreveram não paga nada por mensagem; mensagens de marketing são cobradas por mensagem.

Qual tarefa da Página o envio de mensagem exige?

A visão geral do Messenger da Meta pede um token de Página de alguém que possa executar as tarefas MESSAGING e MODERATE, com a permissão pages_messaging concedida.

A easyCoexistence pode responder com imagens no Messenger?

Hoje não. send_social_dm envia texto, e nenhuma ferramenta envia um anexo.

Quanto custa a easyCoexistence para uma Página do Facebook?

Cada Página que você conecta é uma conexão, cobrada de US$ 9 até US$ 0.75 por conexão por mês conforme a quantidade que você tem, e os primeiros 3 dias são grátis.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorado 24/7

Verificado em