Skip to main content
POST
Envie uma nova mensagem direta para um destinatário.
Preços e limites: cada User Profile pode ter até 1.000 conversas ativas por ciclo de cobrança em todas as redes sociais. O preço depende do seu plano: os planos Premium pagam um add-on fixo de US$ 49 por mês, enquanto os planos Launch e Business são cobrados a US$ 0,09 por conversa ativa. Uma conversa é contada como ativa quando você envia uma mensagem para um destinatário durante o ciclo de cobrança; mensagens recebidas por si só não contam. O número de mensagens dentro de uma conversa ativa é ilimitado.
  • Você pode enviar um emoji como parte do texto da message.
  • As mediaUrls do Facebook e Instagram devem terminar com uma extensão conhecida. Incluir parâmetros de query fará com que a URL da mídia falhe.
Janela de atendimento ao cliente de 24 horas do WhatsApp. O WhatsApp Business só permite mensagens de saída em formato livre dentro de 24 horas após a mensagem mais recente do interlocutor. Após essa janela, os envios serão rejeitados pela Meta até que o interlocutor envie nova mensagem. Mensagens em template fora da janela de 24 horas não são suportadas atualmente por este endpoint.

Parâmetros do header

Parâmetros de path

string
obrigatório
A plataforma para enviar a mensagem: facebook, instagram, twitter, whatsapp

Parâmetros do body

string
obrigatório
O ID do destinatário da mensagem.
  • Para Facebook, Instagram e X/Twitter, este é o ID de usuário específico da plataforma (PSID, IGSID ou user ID).
  • Para o WhatsApp, este é o número de telefone do destinatário em formato E.164 apenas com dígitos (por exemplo, 14155551234, não +1 (415) 555-1234).
string
obrigatório
A mensagem a ser enviada ao destinatário.
  • A message para Facebook, Instagram e WhatsApp pode ser uma string vazia ou ser totalmente omitida quando mediaUrls for fornecido.
  • O X exige uma mensagem com pelo menos um caractere, mesmo que mediaUrls seja fornecido.
array
Array de URLs de mídia para anexar imagens, vídeo, áudio (incluindo mensagens de voz) ou documentos.
  • URLs de itens de mídia devem terminar com a extensão do arquivo, sem parâmetros adicionais anexados.
  • Facebook e Instagram suportam múltiplas URLs de mídia.
  • O X aceita apenas uma única URL de mídia.
  • Mensagens de voz são suportadas no Facebook e Instagram como arquivos aac ou wav.
  • O WhatsApp aceita múltiplas URLs de mídia. A Ayrshare busca cada URL e usa o Content-Type da resposta para selecionar a categoria de mídia do WhatsApp. A Meta aceita:
    • Imagem: .jpg, .jpeg, .png
    • Vídeo: .mp4, .3gp
    • Áudio: .aac, .amr, .mp3, .m4a, .ogg
    • Documento: .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx