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 do Braze e do Facebook utiliza os recursos de webhooks, segmentação, personalização e disparo do 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 Templates > Webhook Templates.

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 aplicativo do Facebook, seu aplicativo precisará ser aprovado na análise de aplicativos do Facebook.
  
  

Integração

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

Etapa 1: Colete seus PSIDs

Para o envio de 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 a 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, seu PSID será incluído na propriedade recipient.id da solicitação para identificar quem deve receber a mensagem.

Etapa 2: Enviar para o Braze como um atributo personalizado

Quando tiver certeza de que está recebendo PSIDs, coordene e compartilhe isso com seus desenvolvedores para enviar os PSIDs ao 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ídias, 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 (Corpo da solicitação ).
4. Adicione seu token de acesso à página no URL do webhook, substituindo FACEBOOK_PAGE_ACCESS_TOKEN pelo seu token.

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

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

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 não estiver enviando mensagens usando os números de telefone dos usuários e planeja enviar mensagens do Messenger repetidamente, você deve criar um segmento para todos os usuários para os quais o Messenger ID existe como um atributo personalizado e ativar análise de dados de rastreamento para rastrear suas taxas de inscrição no Messenger ao longo do tempo.

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.