Skip to content

Facebook Messenger

O Facebook Messenger é uma das plataformas de envio de mensagens instantâneas mais populares do mundo, usada por quase um bilhão de usuários ativos por mês. Por meio dessa plataforma, as marcas podem criar chatbots envolventes para interagir de forma inteligente e automática com seus clientes.

A integração da Braze com o Facebook utiliza os recursos de webhooks, segmentação, personalização e disparo da Braze para enviar mensagens aos seus usuários no Facebook Messenger por meio da API da plataforma do Messenger. Um modelo personalizado de webhook do Facebook Messenger está incluído em nossa plataforma em Modelos > Modelos de webhook.

A plataforma Facebook Messenger é destinada a “mensagens não promocionais que facilitam uma transação pré-existente, fornecem outras ações de suporte ao cliente ou entregam conteúdo solicitado por uma pessoa”. Para saber mais, consulte as diretrizes da plataforma do Facebook e os exemplos de casos de uso aceitáveis.

Pré-requisitos

Confirme o seguinte antes de prosseguir com a integração:

  • O Facebook não permite o uso da plataforma Messenger para o envio de mensagens de marketing.
  • Será necessária a permissão explícita do usuário para o envio de mensagens da sua página.
  • Para enviar mensagens para usuários que não são usuários teste do seu app do Facebook, seu app precisará ser aprovado na análise de aplicativos do Facebook.

Integração

A seguir, mostramos como configurar um webhook do Facebook Messenger na Braze. Para quem precisar de ajuda adicional para configurar seu bot, um tutorial completo do bot do Messenger e um código de exemplo podem ser encontrados no repositório da Braze no GitHub!

Etapa 1: Colete seus PSIDs

Para enviar mensagens no Facebook Messenger, é necessário coletar os IDs específicos da página (PSIDs) dos seus usuários para identificá-los e interagir com eles de forma consistente. Os PSIDs não são os mesmos que o ID do Facebook do usuário. O Facebook cria esse identificador sempre que você envia uma mensagem a um cliente ou quando um cliente envia uma mensagem a você.

Os PSIDs podem ser encontrados usando um dos vários pontos de entrada oferecidos pelo Facebook. Depois que o usuário enviar mensagens ao seu app ou realizar uma ação em uma conversa, como tocar em um botão ou enviar uma mensagem, o PSID dele será incluído na propriedade sender.id do evento do webhook, para que seu bot possa identificar quem realizou a ação.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "message":{
    "mid":"mid.1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!",
    "quick_reply": {
      "payload": "<DEVELOPER_DEFINED_PAYLOAD>"
    }
  }
}

Sempre que você enviar uma mensagem, o PSID será incluído na propriedade recipient.id da solicitação para identificar quem deve receber a mensagem.

Etapa 2: Enviar para a Braze como um atributo personalizado

Quando tiver certeza de que está recebendo PSIDs, coordene e compartilhe isso com seus desenvolvedores para enviar os PSIDs para a Braze como um atributo personalizado. PSIDs são strings que podem ser acessadas por meio de uma chamada de API.

Etapa 3: Configure seu modelo de webhook

Em Modelos e mídia, acesse Modelos de webhook e escolha o Modelo de webhook do Facebook Messenger.

  1. Forneça um nome de modelo e adicione equipes e tags, conforme necessário.
  2. Digite sua mensagem ou escolha um modelo de mensagem dentre os disponibilizados pelo Facebook. Você também pode escolher o tipo de mensagem ou a tag.
  3. Inclua o PSID como um atributo personalizado. Isso pode ser feito usando o botão + azul e branco no canto da caixa Request Body.
  4. Adicione seu token de acesso à página na URL do webhook, substituindo FACEBOOK_PAGE_ACCESS_TOKEN pelo seu token.

Pré-visualização e teste do seu webhook

Antes de enviar sua mensagem, teste seu webhook. Certifique-se de que seu Messenger ID esteja salvo na Braze (ou encontre-o e teste como um usuário personalizado) e use a pré-visualização para enviar a mensagem de teste:

Guia Teste no modelo de webhook do Facebook Messenger, mostrando que é possível fazer uma pré-visualização da mensagem enviando-a para um usuário existente.

Se a mensagem for recebida com êxito, você poderá definir as configurações de entrega.

Usando esta integração

Depois de configurada, use essa integração para direcionar os usuários do Facebook Messenger. Se você não estiver enviando mensagens usando os números de telefone dos usuários e planeja enviar mensagens do Messenger repetidamente, crie um segmento para todos os usuários para os quais o Messenger ID existe como um atributo personalizado e ative o rastreamento de análise de dados para acompanhar as taxas de inscrição no Messenger ao longo do tempo.

Filtro de segmento "messenger_id" definido como "não está em branco".

Se você optar por não criar um segmento específico para assinantes do Messenger, certifique-se de incluir um filtro para o Messenger ID existente para evitar erros.

Você também pode usar outras segmentações para direcionar suas campanhas do Messenger e o restante do processo de criação de campanhas, como acontece com qualquer outra campanha.
New Stuff!