Skip to main content
O pacote está em evolução e seu link de instalação muda a cada nova versão. Se algo não corresponder ao que você vê na tela, confirme com seu Customer Success Manager que você está usando a versão vigente.
Até aqui, as conversas são disparadas a partir do Treble. Com este pacote você pode fazer o contrário: um automation flow do Salesforce dispara uma conversa de WhatsApp do Treble. Serve para casos como: quando um lead muda para um determinado status, enviar automaticamente um template de WhatsApp para ele; ou quando uma solicitação é criada, iniciar a conversa de acompanhamento sem que ninguém precise fazer nada.

​
Antes de começar

A API key é uma credencial com acesso à sua conta do Treble. Não a compartilhe por canais abertos, não a cole em documentos compartilhados e, se você achar que ela foi exposta, peça que seja regenerada.

​
1. Instalar o pacote

Com sua sessão do Salesforce aberta, acesse este link:
Sobre o identificador do link. A parte final (04taj000000A3B7AAK) é o Id da versão do pacote. Quando uma nova versão é publicada, esse Id muda.Se o link não abrir, pedir uma senha de instalação ou instalar algo que não corresponde ao que você vê aqui, provavelmente você está com um link antigo: peça o vigente ao seu Customer Success Manager.
Se sua organização for um sandbox, troque login.salesforce.com por test.salesforce.com no link.
Você verá a tela de instalação do pacote DeployTrebleConversation. Tela de instalação do pacote DeployTrebleConversation Escolha quem pode usá-lo: Clique em Install e aguarde o Salesforce confirmar a instalação.

​
2. Configurar a credencial

O pacote instala uma credencial externa e uma credencial nomeada, que são as que permitem ao Salesforce chamar a API do Treble. Detalhe da credencial externa do Treble
1

Abra Setup → Named Credentials

Você verá a credencial externa treble_api_external_credential e, relacionada a ela, a credencial nomeada treble_api.
2

Confirme a URL (normalmente não é preciso mexer nela)

O pacote já vem com a credencial apontando para https://main.treble.ai. Você não precisa configurá-la: apenas verifique se está assim.
3

Adicione o cabeçalho de autorização

Na credencial externa, na seção Custom Headers, clique em New e crie:Salve.

​
3. Dar permissões aos usuários

O Salesforce não permite usar uma credencial externa sem uma permissão explícita. O pacote traz um conjunto de permissões pronto.
1

Abra Setup → Permission Sets

Procure o conjunto de permissões treble_api_permission.O conjunto de permissões treble_api_permission
2

Confirme o acesso à credencial

Dentro do conjunto, acesse External Credential Principal Access e verifique se o principal do Treble está lá.Seção External Credential Principal Access
3

Atribua o conjunto aos usuários

Clique em Manage Assignments → Add Assignments e selecione os usuários que vão executar os fluxos.Gerenciar atribuições do conjunto de permissões
Se o fluxo é executado de forma automática (por uma mudança de registro, não por alguém que clica), atribua a permissão ao usuário sob o qual o fluxo é executado, não apenas aos administradores. É o erro mais comum nesta parte.

​
4. Criar o fluxo que inicia a conversa

Com o pacote instalado e as permissões atribuídas, a ação do Treble já está disponível no Flow Builder do Salesforce. O exemplo a seguir inicia uma conversa de WhatsApp toda vez que uma conta é criada. A mesma estrutura serve para qualquer outro gatilho.
1

Acesse Flows

No Setup, vá para Process Automation → Flows e clique em New Flow.Flows dentro de Process Automation
2

Escolha o tipo de fluxo

Para que ele seja disparado sozinho quando os dados mudam, escolha Record-Triggered Flow.Escolher Record-Triggered Flow
3

Configure o gatilho e ative o caminho assíncrono

Escolha o objeto (no exemplo, Account), quando ele é disparado (A record is created) e, em Optimize the Flow for, escolha Actions and Related Records.
Este é o passo mais esquecido. Abaixo, ative Add Asynchronous Path.O Salesforce não permite chamar um sistema externo a partir do caminho normal de um fluxo disparado por registro. Sem esse caminho, a ação do Treble vai falhar.
O botão Add Asynchronous PathAo ativá-lo, o fluxo se divide em dois caminhos: Run Immediately e Run Asynchronously.O fluxo com os caminhos imediato e assíncrono
Tudo o que chama o Treble vai no ramo Run Asynchronously.
4

Opcional: guarde em variáveis os dados de que você precisa

Se você quiser ter à mão dados do registro, adicione um elemento Assignment no ramo assíncrono.Elemento Assignment guardando o nome do contatoNo exemplo, o nome do contato que disparou o fluxo é guardado em uma variável contactname. O mesmo é feito com o telefone, que é o dado de que a ação do Treble realmente precisa.
5

Adicione a ação do Treble

No ramo assíncrono, clique em + e escolha Action.Adicionar um elemento ao fluxoEscolher o elemento ActionPesquise treble e selecione Deploy Treble Conversation.Pesquisar e escolher a ação Deploy Treble Conversation
Se ela não aparecer, é um problema de instalação ou de permissões, não do fluxo. Consulte problemas frequentes.
6

Preencha os parâmetros

Parâmetros conversationId e phoneNumberParâmetro opcional deploymentPhone e o resultado
deploymentPhone vem desativado (“Not Included”). Ative-o apenas se for usá-lo.
7

Salve e ative

Clique em Save e depois em Activate. Um fluxo salvo, mas não ativado, não é executado.

​
O que a ação faz por dentro

Vale a pena conhecer duas coisas, porque elas definem o que é possível e o que não é.
A ação retorna uma única saída, result, com um texto:
ou, quando algo falha:
Se você quiser que o fluxo reaja à falha —enviar um e-mail, marcar um campo— é preciso adicionar um elemento Decision que avalie esse texto, por exemplo verificando se ele começa com Error. Não há um campo separado de sucesso ou falha.
A ação envia ao Treble o número de destino e qual campanha iniciar, e nada mais.Isso significa que você não pode passar valores do registro do Salesforce como variáveis do template de WhatsApp a partir deste fluxo. A personalização da mensagem precisa ser resolvida do lado do Treble: a campanha pode ler os dados do Salesforce com os blocos de CRM depois que a conversa for iniciada.É a limitação mais surpreendente deste pacote, e convém tê-la clara antes de desenhar a automação.
A ação aceita lotes, então funciona da mesma forma em um fluxo que processa um registro ou muitos.
Por baixo, a ação chama o endpoint de implantação do Treble, o mesmo usado para iniciar campanhas via API:

Endpoint de implantação
Se você tem duas contas do Treble conectadas ao mesmo Salesforce, precisa configurar o pacote duas vezes, cada uma com sua própria API key. Não é possível unificar as implantações das duas contas em uma única configuração.

​
Problemas frequentes

É o sintoma clássico de uma configuração incompleta: o pacote foi instalado, mas o cabeçalho Authorization ou o conjunto de permissões não estão configurados corretamente.A recomendação da nossa equipe de engenharia nesses casos é desinstalar o pacote e instalá-lo novamente seguindo este guia passo a passo, em vez de tentar corrigir a configuração existente.
Acontece quando a instalação terminou pela metade, mesmo que o e-mail de confirmação do Salesforce tenha chegado.Verifique em Setup → Named Credentials, aba External Credentials, se treble_api_external_credential existe. Se não estiver lá, desinstale o pacote e instale-o novamente.
As duas causas habituais:
  1. O cabeçalho Authorization não foi criado, ou a API key ficou incompleta.
  2. O usuário que executa o fluxo não tem atribuído o conjunto de permissões treble_api_permission.
Pesquise treble no buscador de ações: deve aparecer Deploy Treble Conversation, na categoria Treble.Se não estiver lá, confirme que a instalação do pacote foi concluída corretamente e que seu usuário está dentro do escopo que você escolheu ao instalar (admins, todos ou perfis específicos).
Falta ativar o caminho assíncrono. O Salesforce não permite chamar um sistema externo a partir do caminho imediato de um fluxo disparado por registro.Abra Configure Start, ative Add Asynchronous Path e mova a ação do Treble para o ramo Run Asynchronously.
É o caso da permissão: um fluxo automático é executado sob um usuário diferente do seu. Atribua o conjunto de permissões a esse usuário.

​
Próximos passos

WhatsApp dentro do Salesforce

Para que os assessores respondam sem sair do CRM.

Marketing Cloud

Iniciar conversas a partir do Marketing Cloud.