Front

A integração do Front permite que você aproveite a Transformação de dados da Braze e os webhooks de cada plataforma para configurar um pipeline de SMS conversacional bidirecional.

O webhook de entrada do Front conterá uma carga útil que inclui a mensagem enviada pelo agente ao vivo. A solicitação precisará ser reformatada antes de ser aceita pelos endpoints da Braze. O modelo de Transformação de dados do Front reformatará a carga útil e gravará um evento personalizado no perfil do usuário intitulado Outbound SMS Sent, com o corpo da mensagem sendo passado como uma propriedade do evento.

Antes de configurar uma nova transformação na Braze, recomendamos revisar a matriz de suporte para cada nível em nossa documentação de Transformação de dados. Nossos níveis Free e Pro oferecem um número diferente de transformações ativas e solicitações de entrada por mês. Confirme se o plano atual em que você está pode suportar seu caso de uso.

Pré-requisitos

Antes de começar, você precisará do seguinte:

Casos de uso

• Simplifique seu processo de geração de leads usando o envio automatizado de mensagens SMS da Braze para identificar as preferências do usuário e permitir que agentes de vendas ao vivo façam o acompanhamento e fechem as vendas.
• Reengaje os clientes que abandonaram seus carrinhos de compras, impulsionando as conversões de vendas por meio de respostas automatizadas por SMS e suporte por chat ao vivo.

Integração do Front

Etapa 1: Criar uma transformação de dados

Primeiro, você criará uma nova transformação de dados na Braze. As etapas a seguir são simplificadas; para um passo a passo completo, consulte Criando uma transformação.

1. Na Braze, acesse Configurações de dados > Transformações de dados e selecione Criar transformação.
2. Em Editing Experience, selecione Start from scratch.
3. Em Select Destination, selecione POST: Track Users.

4. Copie e cole o seguinte modelo de transformação e depois salve e ative o endpoint.

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
    // This is a default template that you can use as a starting point. Feel free to delete this entirely to start from
    // scratch, or to delete specific components as you see fit
   
    // First, this code defines a variable, "brazecall", to build up a /users/track request
    // Everything from the incoming webhook is accessible via the special variable "payload". As such, you can template in
    // desired values in your /users/track request with JS dot notation, such as payload.x.y.z
   
    let brazecall = {
    "events": [
      {
      "phone": payload.recipients[1].handle,
      "_update_existing_only": true,
      "name": "Outbound SMS Sent",
      "time": new Date().toISOString(),
      "properties": {
        "message_id": payload.id,
        "message_body": payload.body,
        "front_author_username": payload.author.username
      }
      }
    ]
    };
   
    // After the /users/track request is assigned to brazecall, you will want to explicitly return brazecall to create an output
    return brazecall;
   

   Sua transformação deve ser semelhante à seguinte:

   

Etapa 2: Criar uma campanha de SMS de saída

Em seguida, você criará uma campanha de SMS que ouvirá webhooks do Front e enviará uma resposta de SMS personalizada para seus clientes.

Etapa 2.1: Redija sua mensagem

Na caixa de texto Mensagem, adicione o seguinte código Liquid, juntamente com qualquer linguagem de descadastramento ou outro conteúdo estático.

1
{{event_properties.${message_body}}}

Sua mensagem deve ser semelhante à seguinte:

2.2 Programar a entrega {#22-schedule-the-delivery}

Para o tipo de entrega, selecione Entrega baseada em ação; em seguida, para o gatilho de evento personalizado, selecione Outbound SMS Sent.

Por fim, em Controles de entrega, ative a reelegibilidade.

Etapa 3: Criar um canal personalizado

No dashboard do Front, acesse Settings > Channels > Add Channels, selecione Custom Channel e insira um nome para seu novo canal da Braze.

Etapa 4: Configurar as definições

No campo de endpoint da API de saída, insira a URL do webhook de Transformação de dados que você criou anteriormente. Todas as mensagens de saída de agentes ao vivo no seu novo canal da Braze serão enviadas para cá. Esse canal também fornece uma URL de endpoint para a Braze encaminhar mensagens SMS no campo Incoming URL.

Não se esqueça de anotar essa URL — você precisará dela mais tarde.

Etapa 5: Configurar o encaminhamento de SMS de entrada

Em seguida, você criará duas novas campanhas de webhook na Braze para encaminhar SMS recebidos de clientes para a caixa de entrada do Front.

Etapa 5.1: Criar uma categoria de palavra-chave SMS

No dashboard da Braze, acesse Público, escolha seu grupo de inscrições de SMS e selecione Adicionar palavra-chave personalizada. Para criar uma categoria de palavra-chave de SMS exclusiva para o Front, preencha os campos a seguir.

Etapa 5.2: Crie sua primeira campanha de webhook

No dashboard da Braze, crie sua primeira campanha de webhook usando a URL que você criou anteriormente.

Adicione o seguinte ao corpo da solicitação:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
 "sender": {
  "handle": "{{${phone_number}}}",
  "name": "{{${user_id}}}"
 },
 "body_format": "markdown",
 "metadata": {
  "headers": {
   "first_name": "{{${first_name}}}",
   "last_name": "{{${last_name}}}"
  }
 },
 "body": "{{sms.${inbound_message_body} | default : "no body available" }}"
}

Na guia Configurações, configure os cabeçalhos de solicitação Authorization, content-type e accept.

Etapa 5.3: Agendar a primeira entrega

Em Programar entrega, selecione Entrega baseada em ação e, em seguida, escolha Enviar uma mensagem de entrada SMS para o tipo de gatilho. Adicione também o grupo de inscrições de SMS e a categoria de palavras-chave que você configurou anteriormente.

Em Controles de entrega, ative a reelegibilidade.

Etapa 5.4: Crie sua segunda campanha de webhook

Como sua segunda campanha de webhook é igual à primeira, você pode duplicar a primeira e renomeá-la.

Etapa 5.5: Agendar a segunda entrega

Em Programar entrega, defina o gatilho baseado em ação e o grupo de inscrições de SMS com os mesmos valores da primeira entrega. Porém, para a categoria de palavra-chave, escolha Other.

Etapa 5.6: Adicionar um filtro de público

Sua campanha de webhook agora pode encaminhar respostas de SMS recebidas de seus clientes. Para filtrar as respostas de SMS de modo que somente as mensagens de chats ao vivo sejam encaminhadas, adicione o filtro de segmentação Last Received Message From Specific Campaign à etapa de públicos-alvo.

Em seguida, configure seu filtro:

1. Em Campaign, selecione a campanha de SMS que você criou anteriormente.
2. Em Operator, selecione Less Than.
3. Em Time Window, escolha o período de tempo em que o chat deve permanecer aberto sem uma resposta do cliente.

Considerações

Segmentos faturáveis

• As mensagens SMS na Braze são cobradas por segmento de mensagem. Entender o que define um segmento e como essas mensagens serão divididas é fundamental para entender como você será cobrado pelas mensagens. Para saber mais, consulte nossa documentação.
• Respostas longas dos agentes consumirão mais segmentos faturáveis.

Registro de pontos de dados

No momento, essa integração exige que um evento personalizado seja gravado em um perfil de usuário toda vez que um agente ao vivo envia um SMS pelo Front. Isso pode ser adequado para trocas rápidas que duram apenas algumas mensagens, mas à medida que as conversas se tornam mais longas, as implicações nos pontos de dados também aumentam. Se você tiver dúvidas sobre as nuances dos pontos de dados da Braze, seu gerente de conta da Braze poderá respondê-las.

Inclusão de links em mensagens SMS

O envio de um link pelo chat ao vivo do Front será renderizado com tags HTML extras.

Anexar arquivo de imagem pelo Front

Os arquivos de imagem no Front não serão renderizados em mensagens SMS enviadas pela Braze.

Descadastramento

As mensagens conversacionais têm um risco maior de conter a palavra “pare” ou termos semelhantes que podem ser reconhecidos como descadastramentos imprecisos.