Skip to content

Talkable

A Talkable ajuda marcas de consumo a transformar clientes satisfeitos em um canal de indicação escalável. Com a integração da Braze, os opt-ins de e-mail de marketing capturados nas campanhas de indicação da Talkable fluem para a Braze em tempo real, fornecendo à sua equipe o consentimento, o contexto e os dados de campanha necessários para dar boas-vindas, segmentar e engajar cada novo promotor e amigo indicado.

Esta integração é mantida pela Talkable.

Sobre a integração

A Talkable traz a aquisição liderada por defensores para a jornada do cliente que a Braze potencializa. A integração move cada aceitação de indicação capturada pela Talkable para o perfil correspondente na Braze em tempo real, para que fluxos de boas-vindas, jornadas de indicação, segmentação e envio de mensagens de ciclo de vida possam ser iniciados a partir de consentimento confiável e contexto de indicação — tudo sem exportações manuais de listas ou sincronizações em lote.

A Talkable captura aceitações de marketing em dois cenários:

  • Inscrição do defensor: Um defensor se inscreve em uma campanha de indicação da Talkable e consente em receber e-mails de marketing.
  • Coleta de e-mail do amigo: Um amigo completa a etapa de coleta de e-mail da Talkable e aceita receber e-mails de marketing.

Em ambos os casos, a Talkable cria ou atualiza o perfil de usuário correspondente na Braze em tempo real e define o status de inscrição de e-mail do usuário como Opted In.

Comportamento padrão

A Talkable envia dados para a Braze somente em um evento discreto de aceitação de alguém que consentiu explicitamente na Talkable — seja um defensor se inscrevendo em uma campanha ou um amigo aceitando durante a coleta de e-mail. A Talkable não executa lotes noturnos, sincronizações completas ou atualizações implícitas de perfil. A Talkable nunca envia perfis que não aceitaram receber comunicações para a Braze.

Casos de uso

  • Disparar um Canvas de boas-vindas da Braze no momento em que um promotor se inscreve em uma campanha de indicação da Talkable.
  • Ativar amigos indicados com um Canvas específico para amigos e uma oferta personalizada de primeira compra assim que um amigo fizer a aceitação.
  • Segmentar por contexto de indicação usando sinalizadores de promotor e amigo e metadados de campanha enviados como atributos personalizados da Braze.
  • Direcionar aceitações de indicação para um grupo de inscrições designado da Braze para envio de newsletters em conformidade.

Pré-requisitos

Antes de começar, você precisa do seguinte:

Pré-requisito Descrição
Uma conta Talkable É necessário um site Talkable com pelo menos uma campanha configurada para aproveitar essa parceria.
Uma chave da API REST da Braze Uma chave da API REST da Braze com permissões de users.track. Crie essa chave no dashboard da Braze em Configurações > Chaves de API. Para saber mais, consulte Criando chaves da API REST.
Um endpoint REST da Braze A URL do seu endpoint REST da Braze (por exemplo, https://rest.iad-01.braze.com). Os clusters da Braze nos EUA (.com) e na UE (.eu) são compatíveis. Para saber mais, consulte Endpoints da REST API.

Integração

Etapa 1: Instalar o app da Braze no Talkable

  1. Faça login no painel de administração do Talkable, abra o menu e acesse All Site Settings > App Store.
  2. Localize Braze e selecione Install.
  3. Insira seu endpoint REST da Braze e uma chave da API REST com permissões de users.track, depois selecione Save.

Etapa 2: Configurar a ação de aceitação de e-mail

  1. No app da Braze no Talkable, abra a ação Email opt-in.
  2. (Opcional) Insira um identificador de grupo de inscrições da Braze, adicione atributos personalizados e/ou configure um alias de usuário. Para saber mais, consulte Personalizando o Talkable.
  3. Selecione Save. Deixe a ação desativada para que você possa verificar a configuração com uma carga útil de teste antes que qualquer evento de aceitação ativo comece a sincronizar.

Etapa 3: Testar com uma carga útil de exemplo

  1. No Talkable, selecione Send sample payload na ação Email opt-in para enviar uma solicitação de teste para a Braze.
  2. Na Braze, acesse Audience > User Search e pesquise pelo endereço de e-mail de teste.
  3. Confirme que o perfil existe com Email Subscribe definido como Opted In e que quaisquer atributos personalizados, inscrição em grupo de inscrições ou alias de usuário configurados aparecem conforme esperado.

Etapa 4: Ativar a ação para tráfego ativo

Quando o perfil de teste estiver correto na Braze, retorne ao Talkable e ative a ação Email opt-in.

A partir desse momento, cada evento de aceitação do Talkable sincroniza o perfil correspondente com a Braze em tempo real.

Atributos de usuário padrão enviados para a Braze

Em cada evento de aceitação, o Talkable cria ou atualiza o perfil de usuário correspondente na Braze com os seguintes atributos de usuário padrão da Braze. Valores vazios são omitidos.

Atributo da Braze Tipo Notas
email_subscribe String Definido como Opted In em cada evento de aceitação do Talkable.
email String Identificador principal usado para corresponder ao perfil da Braze.
phone String Capturado apenas como atributo de usuário. A Braze espera o formato E.164; enviado conforme armazenado no Talkable.
first_name String O nome da pessoa.
last_name String O sobrenome da pessoa.
Inscrição em grupo de inscrições Não aplicável O Talkable inscreve o usuário como inscrito quando um grupo de inscrições está configurado.
Alias de usuário Não aplicável Adicionado apenas quando um alias de usuário está configurado. Para saber mais, consulte Personalizando o Talkable.

Personalizar o Talkable

As seguintes personalizações opcionais estão disponíveis. Configure qualquer combinação; elas são independentes.

Inscrever aceitações em um grupo de inscrições da Braze

  1. Na Braze, copie o ID de um grupo de inscrições em Audience > Subscription Group Management. Para saber mais, consulte Gerenciamento de inscrições de usuários.
  2. Na ação Email opt-in do Talkable, cole-o no campo Subscription group identifier.

O Talkable inscreve cada aceitação nesse grupo de inscrições como inscrito, direcionando as aceitações de indicação para esse grupo em vez de uma inscrição global. O Talkable apenas adiciona inscrições; ele nunca as remove.

Enviar atributos personalizados

Adicione qualquer par chave-valor ao editor de carga útil da ação. A chave inserida se torna o nome do atributo no perfil de usuário da Braze.

Os valores são modelados com Liquid. As seguintes variáveis estão disponíveis:

Variável Conteúdo
{{ person }} O promotor ou amigo que aceitou (email, first_name, last_name, phone_number, username, is_advocate, custom_properties e mais).
{{ ip }} O endereço IP de onde a aceitação ocorreu.
{{ campaign }} A Campaign de origem do Talkable (name, type, tag_names e mais).

Exemplo: adicione talkable_is_advocate = {{ person.is_advocate }} e talkable_campaign_name = {{ campaign.name }} para segmentar por contexto de indicação na Braze.

Identificar usuários com aliases de usuário da Braze

No editor de carga útil, adicione user_alias.alias_name (por exemplo, {{ person.username }}) e user_alias.alias_label (por exemplo, username). Para saber mais, consulte Objeto de alias de usuário.

Quando ambos os campos estão presentes, o sistema identifica o usuário pelo alias além do e-mail, e a Braze cria um novo perfil com alias caso não exista correspondência.

Encontrar e criar usuários na Braze

  • Por padrão, a Braze faz a correspondência do perfil pelo endereço de e-mail. Se não existir um perfil correspondente, a Braze cria um novo.
  • Quando um alias de usuário é configurado, a Braze também faz a correspondência por esse alias e cria um novo perfil com alias se não houver correspondência.
  • IDs externos não são usados por essa integração. Para vincular as aceitações do Talkable a um perfil existente identificado externamente, configure um alias de usuário cujo rótulo corresponda ao alias conhecido desse perfil.

Usar o Talkable com a Braze

Encontrar um usuário sincronizado

Acesse Audience > User Search e pesquise por e-mail para visualizar um perfil que o Talkable criou ou atualizou.

Os campos padrão (e-mail, telefone, nome ou sobrenome) e quaisquer atributos personalizados que você configurou aparecem no perfil; Email Subscribe mostra Opted In.

Criar um Segment de indicação

  1. Crie um Segment filtrado em Email Subscribe igual a Opted In.
  2. Refine com os atributos personalizados que o Talkable envia — por exemplo, talkable_is_advocate igual a true para segmentar defensores da marca, ou talkable_campaign_name igual à sua Campaign para segmentar um programa de indicação específico.

Disparar mensagens de ciclo de vida

  1. Crie um Canvas ou uma Campaign com entrega baseada em ação. Os seguintes tipos de disparo da Braze funcionam com essa integração:
    • Update Subscription Status (por exemplo, a inscrição de e-mail muda para Opted In)
    • Update Subscription Group Status (quando um grupo de inscrições está configurado)
    • Change Custom Attribute Value (para qualquer atributo personalizado do Talkable que você enviar).
  2. Personalize as mensagens com os atributos personalizados do Talkable no perfil (nome da Campaign, valor da recompensa, pessoa que indicou e assim por diante).

Considerações

  • Aceitação apenas por e-mail: Os números de telefone são capturados como um atributo de usuário padrão, mas a integração não define um estado de inscrição de SMS. O Talkable não sincroniza aceitações de SMS.
  • Formato de telefone: A Braze espera números de telefone no formato internacional (E.164).
  • Sincronização em tempo real, orientada por eventos: O Talkable envia uma solicitação por evento de aceitação (um usuário por solicitação). Não há agrupamento em lote nem sincronização completa periódica; o volume acompanha o volume de aceitações de indicação.
  • Entrega confiável: Se a Braze retornar temporariamente um erro, o Talkable faz novas tentativas automaticamente. Falhas persistentes enviam um alerta por e-mail para o administrador do site.

Solução de problemas

Erro Causa provável Correção
401 Unauthorized A chave da API REST não tem as permissões users.track, ou o endpoint aponta para o cluster errado. Emita novamente a chave com as permissões users.track e confirme se o endpoint REST corresponde ao seu cluster da Braze.
Endpoint REST rejeitado na instalação A URL não é um endpoint REST da Braze. Use o endpoint REST do seu cluster, por exemplo https://rest.iad-01.braze.com. Uma URL do dashboard não funciona.
Perfil criado, mas não está em um grupo de inscrições Nenhum ID de grupo de inscrições configurado. Insira o ID do grupo de inscrições na ação Email opt-in.
Alias de usuário não aplicado Apenas um dos dois campos de alias (nome ou rótulo) está preenchido. Preencha ambos os campos na ação: nome do alias e rótulo do alias.
Perfil não aparece A solicitação de amostra ainda não foi enviada, ou a ação está desativada. Selecione Send sample payload no Talkable e verifique se a ação Email opt-in está ativada.
As solicitações pararam de ser enviadas após uma rotação de chave A chave de API armazenada foi revogada ou substituída na Braze. Na App Store do Talkable, abra o app da Braze, cole a nova chave da API REST e selecione Save; teste novamente com Send sample payload.

Para saber mais sobre a integração com o Talkable, consulte a documentação de integração Talkable Braze. Para entrar em contato com o suporte do Talkable, envie um e-mail para [email protected].
New Stuff!