Enviar uma mensagem

Este documento descreve as exigências para o envio de mensagens em formato livre de uma conta profissional do Instagram para clientes ou pessoas interessadas na sua conta por meio da plataforma do Messenger from Meta.

É possível enviar mensagens em formato livre com:

• uma imagem, um vídeo, um gif ou um áudio;
• uma reação ou figurinha;
• um texto, incluindo um link.

Antes de começar

Este guia considera que você leu a Visão geral da plataforma do Messenger, implementou os componentes necessários (como uma Página do Facebook vinculada à conta profissional do Instagram ou uma Página de teste), registrou-se como desenvolvedor da Meta e criou um ID do app empresarial no Messenger > produto Mensagens do Instagram no Painel de Apps.

Aconselhamos também que você consulte o status da Plataforma de Desenvolvedores da Meta para verificar se não há nenhum problema.

Requisitos

• O ID da Página do Facebook vinculada à sua conta profissional do Instagram.
• O ID no escopo do Instagram do cliente que enviou a mensagem.
• Um token de acesso à Página solicitado por uma pessoa que pode executar a tarefa MESSAGE na Página do Facebook vinculada à conta profissional do Instagram.
• A permissão instagram_manage_messages.

Limitações

• Os apps com acesso padrão só podem enviar mensagens a pessoas que têm uma função no app.
• Os anexos de mídia podem ser os seguintes:

Para ver mais informações sobre anexos de mídia, consulte Upload Media for Instagram Messaging.

Enviar uma mensagem simples

Para enviar uma mensagem com um texto ou link, faça uma solicitação POST para o ponto de extremidade /PAGE-ID/messages que contenha: 1. o parâmetro recipient com o ID no escopo do Instagram (IGSID, pelas iniciais em inglês) e 2. o parâmetro message com um texto ou link.

O texto da mensagem deve estar em UTF-8 e ter até 1.000 bytes. Os links devem ser URLs formatadas corretamente.

Exemplo de solicitação

Texto formatado para facilitar a leitura.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={"text":"TEXT-OR-LINK"}'

Exemplo de resposta de API

Se o processo for bem-sucedido, o app receberá a seguinte resposta JSON:

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

Enviar uma publicação existente

Para enviar uma mensagem com uma publicação sua existente no Instagram, faça uma solicitação POST para o ponto de extremidade /PAGE-ID/messages que contenha: 1. o parâmetro recipient com o ID no escopo do Instagram (IGSID) e 2. o parâmetro message contendo um objeto attachment cujo type esteja definido como MEDIA_SHARE, além do payload com o ID da Meta da publicação.

A empresa deve ter uma mídia própria para usar na mensagem.

Exemplo de solicitação

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={
      "attachment": 
        {
          "type":"MEDIA_SHARE", 
          "payload":{"id":"POST-ID"}
        }
}’

Exemplo de resposta de API

Se o processo for bem-sucedido, o app receberá a seguinte resposta JSON:

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

Enviar uma figurinha

Para enviar uma figurinha de coração, faça uma solicitação POST para o ponto de extremidade /PAGE-ID/messages que contenha: 1. o parâmetro recipient com o ID no escopo do Instagram (IGSID) e 2. o parâmetro message com um objeto attachment cujo type esteja definido como like_heart.

Exemplo de solicitação

Texto formatado para facilitar a leitura.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={
      "attachment": 
        {
          "type":"like_heart"
        }
}’

Exemplo de resposta de API

Se o processo for bem-sucedido, o app receberá a seguinte resposta JSON:

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

Reagir a uma mensagem

Para enviar uma reação, faça uma solicitação POST para o ponto de extremidade /PAGE-ID/messages que contenha: 1. o parâmetro recipient com o ID no escopo do Instagram (IGSID), 2. o parâmetro sender_action de react e 3. o payload com message_id definido como o ID da mensagem reagida, além da reaction de love.

Exemplo de solicitação

Texto formatado para facilitar a leitura.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&sender_action=react&payload={
      "message_id":"MESSAGE-ID",
      "reaction":"love",
}'

Para remover uma reação de uma mensagem, faça uma solicitação POST para o ponto de extremidade /PAGE-ID/messages que contenha: 1. o parâmetro recipient com o ID no escopo do Instagram (IGSID), 2. o parâmetro sender_action de unreact e 3. o payload com o message_id definido como o ID da mensagem cuja reação será removida.

Exemplo de solicitação

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id”:”IGSID”}&sender_action="unreact"&payload={
      “message_id":"MESSAGE-ID",
}'

Exemplo de resposta

Se o processo for bem-sucedido, o app receberá a seguinte resposta JSON para solicitações de reagir e remover reação:

{
  "recipient_id": "IGSID"
}

Próximas etapas

• Carregar mídias (como áudio ou imagem) nos servidores da Meta para usar em várias mensagens.

• Enviar uma mensagem estruturada, como um modelo genérico, modelo de produto ou menu persistente.

Veja também

• Códigos de erro
• Limite de volume para Mensagens do Instagram
• ID de mídia para ativos de mídia