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.
Chamadas da Send API que um app pode fazer por Página para mensagens com texto, links, reações e stickers.
Chamadas da Send API que um app pode fazer por Página para mensagens que contêm áudio ou vídeo.
Maior ativo que a Messenger Platform salva para reutilização; uma imagem enviada por URL tem limite de 8 MB.
Maior número de imagens que uma mensagem pode levar no array attachments, o único tipo de mídia permitido ali.
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:
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_idoupost_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_tocom 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, ouSILENT_PUSHouNO_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_messagingseja 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.
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