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 Send API.

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 uma publicação 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 publicação ou comentário: um ID atribuído a uma pessoa que fez uma publicação na sua Página ou comentou em uma publicação. 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/v21.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 a 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/v21.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 uma 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 API de Carregamento de Anexos.

Boas práticas

Mensagens de texto

Anexos

Outros tipos de mensagem

Mensagens de notícias (em desenvolvimento)

Mensagens de notícias: estão disponíveis apenas para publishers registrados no Índice de Páginas de notícias (NPI, pelas iniciais em inglês) do Facebook. Com esse recurso, os publishers podem enviar mensagens de notícias não promocionais para pessoas que se inscreveram para receber esse tipo de conteúdo.

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

Notificações únicas

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 uma das suas publicações ou anúncios, assim como quando ela faz uma publicação 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 a publicação ou o comentário. Além disso, ela deve ser enviada até sete dias após a publicação ou o comentário da pessoa.

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 patrocinadas

Mensagens patrocinadas: permitem enviar conteúdo promocional ou não promocional após a expiração da janela-padrão de mensagens para uma pessoa que já mandou uma mensagem para 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 precisa estar em conformidade com as Políticas de Publicidade.

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

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 Send API : 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.