Frente

A integração da Front o capacita a aproveitar a transformação de dados do Braze e os webhooks de cada plataforma para configurar um pipeline de SMS de conversação bidirecional.

O webhook de entrada do Front conterá uma carga útil que inclui a mensagem enviada pelo agente em tempo real. A solicitação precisará ser reformatada antes da aceitação pelos endpoints da Braze. O modelo Front Data Transformation reformatará a carga útil de SMS 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 no Braze, recomendamos revisar a matriz de suporte para cada camada 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 do Braze para identificar as preferências do usuário e ativar os agentes de vendas ao vivo para acompanhar e fechar 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 bate-papo ao vivo.

Integração da 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 obter um passo a passo completo, consulte Criação de uma transformação.

1. No Braze, acesse Configurações de dados > Transformações de dados e selecione Criar transformação.
2. Em Editing Experience, selecione Start from scratch (Começar do zero).
3. Em Select Destination (Selecionar destino), selecione POST: Rastreamento de usuários.

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 uma resposta de SMS personalizada para seus clientes.

Etapa 2.1: Crie sua mensagem

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

1
{{event_properties.${message_body}}}

Sua mensagem deve ser semelhante à seguinte:

2.2 Programar a entrega

Para o tipo de entrega, selecione Entrega baseada em ação; em seguida, para o disparo de evento personalizado, selecione SMS de saída enviado.

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

Etapa 3: Criar um canal personalizado

No painel frontal, acesse Settings > Channels > Add Channels (Configurações > Canais > Adicionar canais), selecione Custom Channel (Canal personalizado ) e digite um nome para seu novo canal do Braze.

Etapa 4: configurar as definições

No campo endpoint da API de saída, digite o URL do webhook de transformação de dados que você criou antes. Todas as mensagens enviadas por agentes ao vivo em seu novo canal do Braze serão enviadas para cá. Esse canal também fornece um URL de endpoint para o Braze encaminhar mensagens SMS no campo URL de entrada.

Não se esqueça de anotar esse URL - você precisará dele mais tarde.

Etapa 5: Configurar o encaminhamento de SMS de entrada

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

Etapa 5.1: Criar uma categoria de palavra-chave SMS

No dashboard do 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 do Braze, crie sua primeira campanha de webhook usando o 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 “Settings” (Configurações), configure os cabeçalhos de solicitação Authorization, content-type e accept.

Etapa 5.3: Agendar a primeira entrega

Em Entrega programada, selecione Entrega baseada em ação e, em seguida, escolha Enviar uma mensagem de entrada SMS para o tipo de disparo. 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 corresponderá à primeira, você pode duplicar a primeira e renomeá-la. Você pode fazer isso agora.

Etapa 5.5: Agendar a segunda entrega

Para Programar entrega, defina o disparo baseado em ação e o grupo de inscrições de SMS como os mesmos da primeira entrega. Entretanto, para a categoria de palavra-chave, escolha Other (Outra).

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 ativos 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 (Campanha), selecione a campanha de SMS que você criou anteriormente.
2. Em Operador, selecione Menor que.
3. Em Janela de tempo, escolha o período de tempo em que o bate-papo deve permanecer aberto sem uma resposta do cliente.

Considerações

Segmentos faturáveis

• As mensagens SMS no Braze são cobradas por segmento de mensagem. Entender o que define um segmento de mensagens 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.

Consumo de pontos de dados

No momento, a integração exige que um evento personalizado seja gravado em um perfil de usuário toda vez que um agente envia um SMS pela Front. Isso pode ser adequado para trocas rápidas que duram apenas algumas mensagens, mas à medida que as conversas se tornam mais longas, o mesmo acontece com as implicações dos pontos de dados. Um ponto de dados é consumido para cada evento personalizado registrado no Braze.

Inclusão de links em mensagens SMS

O envio de um link do bate-papo ao vivo da Front será renderizado com tags HTML extras.

Anexar arquivo de imagem pela Front

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

Aceitação

As mensagens de conversação têm um risco maior de conter a palavra “pare” ou outra semelhante que possa ser reconhecida como uma cancelamento de inscrição impreciso.