Messenger Send API: enviar mensagens a partir 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 destinatário tem o ID de âmbito da Página da pessoa (PSID), messaging_type é RESPONSE ou UPDATE dentro da janela normal de mensagens ou MESSAGE_TAG depois dela, e message contém texto ou um anexo, como uma imagem, áudio, vídeo ou ficheiro. A Meta responde com recipient_id e message_id.
A easyCoexistence responde a DMs no Messenger com send_social_dm a partir do Claude, do ChatGPT ou do seu próprio código, dentro da janela de 24 horas, como texto; multimédia, respostas rápidas e templates não estão cobertos.
Chamadas da Send API que uma aplicação pode fazer por Página para mensagens com texto, links, reações e autocolantes.
Chamadas da Send API que uma aplicação pode fazer por Página para mensagens que contêm áudio ou vídeo.
Maior recurso que a Messenger Platform guarda para reutilização; uma imagem carregada de um URL está limitada a 8 MB.
Número máximo de imagens que uma mensagem pode levar no array attachments, o único tipo de multimédia aceite aí.
Duração de um attachment_id guardado antes de o multimédia ter de ser carregado novamente.
O que contém um pedido à Send API?
A Meta indica seis componentes que um envio tem de incluir: o ID da Página que envia, o ID da pessoa que recebe, um token de acesso da Página, a autorização da pessoa, o tipo de mensagem e o conteúdo. O pedido é um POST de JSON para /{page-id}/messages, e uma resposta a alguém que acabou de escrever tem este aspeto:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }Que ID vai em recipient?
Normalmente o ID limitado à Página, ou PSID, que a Meta atribui a uma pessoa na primeira vez que ela escreve à Página; 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 essa pessoa e essa Página.
user_ref: para alguém que usou um plugin ou um botão postback para escrever à Página.comment_idoupost_id: para uma resposta privada a um comentário ou a uma publicação de um visitante.- Os IDs do Facebook Login têm âmbito de aplicação e não funcionam na Messenger Platform.
Que messaging_type deve usar uma mensagem?
O tipo indica à Meta porque é que a mensagem é enviada, e decide quando o envio é permitido. A referência das mensagens de Página da Meta lista quatro valores:
- RESPONSE: uma resposta a uma mensagem que a Página recebeu, promocional ou não, dentro da janela normal de mensagens.
- 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 etiqueta que corresponde a um caso de uso aprovado.- UTILITY: uma mensagem de utilidade criada a partir de um template aprovado, como uma atualização de encomenda ou de marcação.
O que pode levar uma mensagem?
Texto, ou um objeto de anexo com um tipo e um payload: os anexos de imagem, áudio, vídeo e ficheiro apontam para um URL ou para um attachment_id guardado, e os anexos de template transportam mensagens estruturadas com botões. O mesmo endpoint aceita também estes campos:
- attachments: um array de até 30 imagens enviadas numa única 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 escrita, uma marca de leitura ou uma reação, enviado num pedido separado da própria mensagem.notification_type: REGULAR por predefinição, ouSILENT_PUSHouNO_PUSH.
Qual o tamanho máximo dos anexos?
O guia da Meta para guardar recursos define os limites para o multimédia que a Messenger Platform obtém e mantém: recursos até 25 MB, imagens até 8 MB quando carregadas de um URL, áudio enviado com um Content-Type de áudio, e vídeo obtido no prazo de 75 segundos. Definir is_reusable como true devolve um attachment_id que só a Página que o enviou pode reutilizar, durante 90 dias, e POST /{page-id}/message_attachments carrega o multimédia antecipadamente.
Quais são os limites de taxa da Send API?
A Meta conta-os por Página e por tipo de conteúdo. A referência de mensagens de Página lista o erro 613, Calls to this api have exceeded the rate limit, entre os erros de envio, por isso abrande em vez de voltar a tentar de imediato quando ele aparecer:
- 300 chamadas por segundo por Página para mensagens com texto, links, reações e autocolantes.
- 10 chamadas por segundo por Página para mensagens com áudio ou vídeo.
- Demasiadas mensagens para uma única conversa podem ser limitadas por taxa por si só.
- Chamadas da API do Messenger no total: 200 vezes o número de utilizadores envolvidos, em janelas móveis 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 descer.
Que erros devolve a Send API?
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 é enviada fora da janela permitida.
- 10 com 2018300: outra aplicação controla a conversa.
- 100: Parâmetro inválido, como um ID de destinatário errado; o subcódigo 2018001 indica No matching user found.
- 551: a pessoa não está disponível, por ter talvez bloqueado a Página ou desativado a conta; 200 com 1545041 indica This person isn't available right now.
- 200 com 2018028: a aplicação não pode enviar mensagens a pessoas fora dos seus papéis até que
pages_messagingseja revista e a aplicação esteja publicada. - 10904: The page has messages disabled in the settings.
Como é que a easyCoexistence envia através dela?
O send_social_dm recebe o account_id, o recipient_id da pessoa, que é o sender.id num evento de mensagens encaminhado, e o texto, e publica-os em /{page-id}/messages com messaging_type RESPONSE. O resultado é a resposta da Meta com o message_id, e um envio recusado devolve o código e a mensagem de erro da Meta. Multimédia, respostas rápidas, templates e ações do remetente não estão entre as tools: o send_social_dm envia texto.
Erros comuns
- Enviar um indicador de escrita junto com a mensagem. A Meta quer sender_action sozinho com o destinatário, e o texto ou os templates num pedido separado.
- Disparar uma rajada para uma só pessoa. A Meta pode limitar uma única conversa por si só, para além das 300 chamadas por segundo da Página.
- Enviar áudio ou vídeo à taxa do texto. As mensagens com áudio ou vídeo estão limitadas a 10 chamadas por segundo por Página.
- Reutilizar um attachment_id com mais de 90 dias. Os IDs de anexo guardados expiram, por isso o multimédia tem de ser carregado de novo para obter outro.
As automatizações respondem a novas mensagens por conta própria, com um texto fixo ou uma resposta de IA. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
A Send API de Messenger é gratuita?
Sim, para as mensagens normais. A visão geral do Messenger da Meta indica que a Messenger Platform é gratuita, por isso uma Página que responde a pessoas que lhe escreveram não paga nada por mensagem; as mensagens de marketing são cobradas por mensagem.
Que tarefa de Página é necessária para enviar uma mensagem?
A visão geral do Messenger da Meta pede um token de acesso da Página a 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. O send_social_dm envia texto, e nenhuma tool envia um anexo.
Quanto custa a easyCoexistence para uma Página do Facebook?
Cada Página que liga à easyCoexistence conta como uma ligação, cobrada de US$ 9 a US$ 0.75 por ligação por mês, conforme o número que tem, e os primeiros 3 dias são grátis.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em