Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

300 per second

Chamadas da Send API que uma aplicação pode fazer por Página para mensagens com texto, links, reações e autocolantes.

10 per second

Chamadas da Send API que uma aplicação pode fazer por Página para mensagens que contêm áudio ou vídeo.

25 MB

Maior recurso que a Messenger Platform guarda para reutilização; uma imagem carregada de um URL está limitada a 8 MB.

30 images

Número máximo de imagens que uma mensagem pode levar no array attachments, o único tipo de multimédia aceite aí.

90 days

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:

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>" }

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_id ou post_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_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 escrita, uma marca de leitura ou uma reação, enviado num pedido separado da própria mensagem.
  • notification_type: REGULAR por predefinição, ou SILENT_PUSH ou NO_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_messaging seja 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.
Fazer isto com a EasyCoexistence

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