Enviar uma mensagem

Para enviar mensagens a alguém no Messenger ou no Instagram, a conversa precisa ser iniciada pela pessoa. Há vários tipos diferentes de mensagens na plataforma do Messenger para você enviar. Cada tipo de mensagem tem políticas e diretrizes referentes aos tipos de conteúdo e às condições de envio.

Componentes da mensagem

As solicitações da Send API feitas pelo seu app para enviar uma mensagem precisam incluir o seguinte:

• A identificação da Página do Facebook ou da Página do Facebook vinculada à conta profissional do Instagram que enviará a mensagem
• A identificação da pessoa que receberá a mensagem
• O token de acesso à Página solicitado pela Página que enviará a mensagem
• A permissão da pessoa que receberá a mensagem
• O tipo da mensagem
• O conteúdo da mensagem

Para obter mais informações sobre os componentes da mensagem, consulte a referência da API de Envio.

Janela-padrão de mensagens

A janela-padrão de mensagens é o período de 24 horas em que você tem permissão para enviar uma mensagem a uma pessoa. Quando uma pessoa envia uma mensagem à sua Página ou conta profissional do Instagram ou inicia uma conversa usando um plugin da web, seu app tem até 24 horas para responder.

As mensagens enviadas dentro da janela de 24 horas podem ter conteúdo promocional.

Ações do usuário que abrem a janela-padrão de mensagens

As ações do usuário a seguir abrem a janela-padrão de mensagens de 24 horas:

• Uma pessoa envia uma mensagem para sua Página ou conta profissional do Instagram.
• Na conversa, uma pessoa clica em um botão de chamada para ação, como Começar.
• Uma pessoa clica em um anúncio com clique para o Messenger e envia uma mensagem para sua Página ou conta profissional do Instagram.
• Uma pessoa envia uma mensagem para uma Página usando um plugin, como Enviar para o Messenger ou Caixa de seleção.
• Uma pessoa clica em um link m.me que a leva a uma conversa existente entre ela e a Página.
• Uma pessoa clica em um link ig.me que a leva a uma conversa existente entre ela e a conta profissional do Instagram.
• Uma pessoa reage a uma mensagem, como uma mensagem de marketing.
• Uma pessoa faz um comentário em um post na sua Página ou conta profissional do Instagram.
• Uma pessoa faz uma publicação de visitante na sua Página.

Sabemos que as pessoas querem receber retornos imediatos. Por isso, recomendamos que você responda o mais rápido possível dentro da janela de 24 horas. As pessoas podem bloquear ou silenciar uma conversa a qualquer momento.

IDs de destinatário

O ID da pessoa que recebe a mensagem é definido no parâmetro do objeto recipient e pode ser de um dos tipos a seguir.

• ID no escopo da Página (PSID, pelas iniciais em inglês): um ID atribuído a uma pessoa na primeira vez que ela envia uma mensagem para sua Página. Essa identificação única representa as interações entre sua Página e a pessoa.

• Referência do usuário: um ID atribuído a uma pessoa que usou um plugin ou botão de postback para enviar uma mensagem para sua Página.

• ID de post ou comentário: um ID atribuído a uma pessoa que fez um post na sua Página ou comentou em um post. Usado para enviar uma resposta privada à pessoa.

Observe que o ID do usuário de integrações do Login do Facebook tem escopo no app e não funcionará na plataforma do Messenger.

Tipos de mensagem

O tipo da mensagem enviada é definido no parâmetro messaging_type. Essa é uma maneira mais explícita de garantir que o conteúdo compartilhado esteja em conformidade com as políticas de mensagens e as preferências do destinatário.

Permitimos os seguintes tipos de mensagens.

• Resposta: a mensagem enviada é uma resposta a uma mensagem recebida. A mensagem pode incluir conteúdo promocional e não promocional. Além disso, ela precisa ser enviada durante a janela-padrão de mensagens.

• Atualizações: a mensagem está sendo enviada proativamente e não ocorre em resposta a uma mensagem recebida. A mensagem pode incluir conteúdo promocional e não promocional. Além disso, ela precisa ser enviada durante a janela-padrão de mensagens.

• Mensagem marcada: é uma mensagem enviada fora da janela-padrão. Ela deve incluir uma tag de mensagem que corresponda ao caso de uso permitido da tag e ter conteúdo não promocional.

Tags de mensagem

As tags de mensagem permitem que você mande uma mensagem fora da janela-padrão de envio. Essas mensagens são atualizações relevantes para uma pessoa. Por exemplo, é possível enviar atualizações sobre envios e entregas, uma reserva ou voo próximo, bem como alertas sobre a conta de um cliente. Para fluxos de mensagens que exigem um caminho de escalação, a marcação de agente humano permite que um representante da empresa responda manualmente às mensagens de uma pessoa em um período de 7 dias.

As tags de mensagem não podem ser usadas para enviar conteúdo promocional, incluindo promoções, ofertas, cupons e descontos, entre outros. O envio fora dos casos de uso aprovados pode resultar em restrições no envio de mensagens na Página ou na conta do Instagram. Consulte a Visão geral da Política da Plataforma do Messenger e da API de Mensagens do IG para mais detalhes.

Para enviar uma mensagem promocional fora da janela-padrão de 24 horas, as empresas que usam a plataforma do Messenger deverão optar pelas mensagens patrocinadas ou notificações únicas.

Tipos de conteúdo

A mensagem enviada pode incluir os seguintes tipos de conteúdo:

Enviar uma mensagem de texto simples

Para mandar uma resposta de texto simples a uma pessoa que mandou uma mensagem à sua Página, envie uma solicitação POST para o ponto de extremidade /PAGE-ID/messages com o id da chave do literal do objeto recipient definido como o ID no escopo da Página, o parâmetro message_type definido como RESPONSE e o text do objeto do parâmetro message definido como o texto da mensagem.

Exemplo de solicitação

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text":"Hello, world!"
  }
}' "https://graph.facebook.com/v25.0/{PAGE-ID}/messages?access_token={PAGE-ACCESS-TOKEN}"
    

Se o processo for bem-sucedido, seu app receberá a seguinte resposta JSON com os IDs do destinatário e da mensagem.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Enviar um anexo de mídia

Para enviar uma mensagem com mídia, como GIF ou imagem, ou um modelo, adicione o conteúdo à solicitação da API em um objeto de anexo de mensagem JSON.

Para mandar uma resposta com imagem a uma pessoa que mandou uma mensagem à sua Página, envie uma solicitação POST ao ponto de extremidade /PAGE-ID/messages com o id da chave do literal do objeto recipient definido como o ID no escopo da Página, o parâmetro message_type definido como RESPONSE, a chave type do objeto attachment do parâmetro message definida como image e a chave url do objeto payload definida como o URL da imagem.

Exemplo de solicitação

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"1254459154682919"
  },
  "message":{
    "attachment":{
      "type":"image", 
      "payload":{
        "url":"http://www.messenger-rocks.com/image.jpg", 
        "is_reusable":true
      }
    }
  }
}' "https://graph.facebook.com/v25.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

Se o processo for bem-sucedido, seu app receberá a seguinte resposta JSON com os IDs do destinatário e da mensagem.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

O mesmo formato será usado para o envio de áudio, vídeo ou arquivo de um URL.

Também é possível enviar mídia do seu servidor ou do conteúdo que você carregou anteriormente para um servidor da Meta. Saiba mais sobre como carregar arquivos usando a Referência da API de Carregamento de Anexos.

Enviar vários anexos de mídia

Para enviar uma mensagem com várias imagens, adicione o conteúdo à solicitação da API em uma matriz de anexos de mensagem JSON. O único tipo de mídia permitido é uma imagem, e o limite é de 30 imagens de cada vez.

Para mandar uma mensagem com várias imagens a uma pessoa que mandou uma mensagem à sua Página, envie uma solicitação POST ao ponto de extremidade /PAGE-ID/messages com o id da chave do literal do objeto recipient definido como o ID no escopo da Página, o parâmetro message_type definido como RESPONSE, e o parâmetro message contém uma matriz attachments onde cada chave type do objeto do anexo definida como image e a chave url do objeto payload definida como o URL da imagem.

Exemplo de solicitação

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "1254459154682919"
  },
  "message": {
    "attachments": [
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      },
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      }
    ]
  }
}' "https://graph.facebook.com/v25.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

Se o processo for bem-sucedido, seu app receberá a seguinte resposta JSON com os IDs do destinatário e da mensagem.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Responder a uma mensagem

Para responder a uma mensagem específica anterior na conversa, envie uma solicitação POST para /PAGE-ID/messages com o seguinte:

• A chave id do objeto literal recipient definida como o ID no escopo da Página da pessoa
• message_type definido como RESPONSE
• Os detalhes da mensagem no objeto de parâmetro da mensagem
• A chave mid do objeto literal reply_to definida como o ID da mensagem específica na conversa que você quer responder

A mensagem pode ser a enviada pela Página ou pelo usuário.

Exemplo de solicitação

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "<PSID>",
  }
  "messaging_type": "RESPONSE"
  "message": {
    "text": "Hello, world!"      
  },
  "reply_to": {
    "mid": "{MESSAGE_ID}"
  }
}' "https://graph.facebook.com/v23.0/{PAGE-ID}/messages?access_token={PAGE_ACCESS_TOKEN}" 

Se o processo for bem-sucedido, seu app receberá a seguinte resposta JSON com os IDs do destinatário e da mensagem.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U…"
} 

Boas práticas

Mensagens de texto

• Seja breve. Considere o tamanho da tela e o comportamento de rolagem; mensagens compactas são mais fáceis de acompanhar. Tente enviar algumas mensagens separadas em vez de uma longa.
• Não use texto como substituto de imagens, tabelas e gráficos. Mensagens estruturadas ou até mesmo uma webView podem atender melhor às suas necessidades.
• Não escreva exposições longas. Se for necessário comunicar várias coisas, tente enviar algumas mensagens separadas em vez de uma longa.

Anexos

• Preste atenção à qualidade. Use imagens coloridas com resolução alta para destacar suas mensagens.
• Considere a taxa de proporção. Analise se a sua imagem pode ficar cortada quando aparecer no balão de mensagens.
• Não coloque grandes quantidades de texto na sua imagem. Em vez disso, use uma mensagem de texto ou combine imagens e texto com um modelo genérico.

Outros tipos de mensagem

Mensagens de marketing

Mensagens de marketing: possibilitam solicitar permissão de uma pessoa para enviar várias mensagens de marketing após o término da janela-padrão. Se a pessoa aceitar, você poderá enviar a ela mensagens promocionais recorrentes automatizadas com informações sobre suas próximas ofertas ou lançamentos e atualizações de produtos.

Mensagens de notícias (em desenvolvimento)

As Mensagens de Notícias: estão disponíveis apenas para publishers de notícias registrados no Índice de Página de Notícias (NPI) do Facebook. As mensagens de notícias permitem que os publishers enviem mensagens de notícias não promocionais às pessoas que assinaram para receber essas mensagens.

As mensagens de notícias não estão disponíveis para a API de Mensagens do Instagram.

Notificação única

Notificação única: possibilita solicitar a permissão de uma pessoa para enviar uma mensagem de acompanhamento após o término da janela-padrão de envio. Se a pessoa aceitar, você poderá enviar uma mensagem com tempo limitado e relevância pessoal, como um lembrete de compromisso ou alerta de estoque reabastecido.

As notificações únicas não estão disponíveis para a API de Mensagens do Instagram.

Respostas privadas

Respostas privadas: permitem que você envie uma mensagem para uma pessoa quando ela faz um comentário em um dos seus posts ou anúncios, assim como quando ela faz um post de visitante na sua Página ou conta profissional do Instagram. A resposta privada deve ser uma única mensagem que incluirá automaticamente um link para o post ou o comentário. Além disso, ela deve ser enviada até sete dias após a publicação do post ou do comentário da pessoa.

Mensagens patrocinadas

Com as mensagens patrocinadas, é possível enviar conteúdo promocional ou não promocional depois que a janela de mensagens padrão expirou para uma pessoa que já tiver enviado uma mensagem à sua Página ou conta profissional do Instagram. Na conversa, elas aparecem como mensagens comuns, mas exibem a palavra "Patrocinado" acima delas. O conteúdo das mensagens patrocinadas deve obedecer às Políticas de Publicidade.

As mensagens patrocinadas não estão disponíveis para a API de Mensagens do Instagram.

Mensagens de utilidade

As mensagens de utilidade permitem que você envie um modelo de mensagem pré-aprovado que inclui pedidos, atualizações de contas e marcação de horários. Essas mensagens são personalizadas com números de contas, identificações de pedidos, números de rastreamento de envio, data e hora do compromisso. Podem ter chamadas para ação que permitem ao usuário cancelar um pedido, reagendar um horário e outras ações que facilitam a interação com uma empresa.

Próximas etapas

Saiba mais sobre os Componentes da conversa.

Saiba mais

Saiba mais sobre como enviar mensagens usando a plataforma do Messenger.

• Referência da API de Carregamento de Anexos: saiba mais sobre como carregar e enviar mídias.
• Referência da API de Envio: saiba mais sobre tags, conteúdo e anexos que você pode enviar.
• Limites de volume: conheça os limites de volume para o envio de mensagens pela plataforma do Messenger.