Antes de mais nada, você precisa integrar o Zenvia Bots, para mais informações sobre como fazer isso consulte esse artigo.
Caso esteja corretamente integrado, será possível observar um "OK" em verde, como demonstrado abaixo:
Para visualizar a API Key dessa integração, clique no ícone do Zenvia Bots e a seguinte tela será exibida:
No próximo passo, iremos usar a API Key na configuração dos plugins no Bots.
Configurando os plugins no Zenvia Bots
Logo de criar o seu fluxo no App.zenvia → Produtos → Bots → Novo Fluxo:
Selecione o plugin “Consultar contato carteirizado”:
A principal função desse plugin é verificar se o contato já se encontra na base de dados do Zenvia Conversion (considerando a linha de WhatsApp e o grupo com o qual o contato está interagindo).
Se já é um contato conhecido com um consultor atribuído, a conversa será transferida diretamente para esse consultor específico.
Em seguida, uma nova janela se abrirá onde você deve colar a informação da API Key anteriormente gerada no campo Token Sirena:
Você também precisará adicionar o "Plugin Sirena". A principal função desse plugin é transferir a conversa para o Zenvia Conversion.
Existem 4 maneiras de transferir uma conversa do Zenvia Bots para o Conversion:
Diretamente para o consultor designado quando é um contato pré-existente (novo): Nesse caso, recomendamos que você adicione um grupo para transferir os contatos caso o contato ainda não tenha sido atribuído.
Configurar um grupo padrão (Grupo fixo secundário) para criar uma fila de conversas em um grupo específico: Nesse campo, adicionamos o ID do grupo.
Configurar um grupo fixo (Grupo padrão para transbordo) para transferir todas as conversas para um grupo fixo em todas as ocasiões.
Disponibilizar os grupos (departamentos) disponíveis para seleção por parte dos clientes.
Acesse o fluxo no qual você pretende adicioná-lo e clique no ícono de "+":
Selecione a opção Plugin Sirena, como demonstrado na imagem abaixo:
A janela do componente será exibida:
De volta ao Zenvia Conversion, clique no botão localizado ao lado do campo API Key para copiá-la:
Por fim, basta colar essa API Key no campo Token Zenvia Conversion do Bots:
Ainda nesta janela, expanda a caixa "Mais Parâmetros" clicando no ícone localizado a direita:
Será exibido o campo Telefone do usuário, adicione a variável #{fone}, conforme demonstrado no exemplo abaixo:
Você também poderá configurar um grupo padrão (grupo fixo secundário) para criar uma fila de conversas em um grupo específico.
Nesse caso, o ID do grupo é:
ID Group
Diretamente para o consultor designado quando é um contato pré-existente;.
Sugerimos usar a variável:
#{agentGroupId}
Nesse caso, recomendamos que você adicione um grupo para transferir os contatos caso ainda não tenha sido atribuído.
As outras opções dessa janela podem ser configuradas conforme as necessidades do próprio usuário. Clique no botão "OK" para concluir essas configurações:
Além dessas configurações, também é necessário editar o "Evento Inicial".
Configurando o Evento Inicial
No fluxo, clique no botão de lápis localizado no canto superior direito do Evento Inicial para editá-lo:
Na janela de edição adicione as variáveis para serem usadas no fluxo, conforme abaixo:
Nome | Expressão |
username | visitor.firstName |
fone | from |
Para certificar-se que a sintaxe está correta, recomendamos copiar e colar as variáveis da tabela acima.
Para confirmar suas alterações clique em "OK":
Por fim, a última alteração que precisamos fazer é adicionar um código JSon.
Configurando o JSon
Clique na seta localizada no lado direito do seu fluxo:
Na janela exibida, será necessário adicionar o seguinte Json no fim do código:
1 2 "defaultConversationalChannel": "WHATSAPP", "historic": true
Para certificar-se que a sintaxe está correta, você pode copiar o snippet acima e colar no código do seu Zenvia Bots.
Confira na imagem abaixo a posição na qual esse Json deve estar:
Após salvar e colocar suas configurações no ar, a sua integração com a Zenvia Conversion + Zenvia Bots já estará funcionando corretamente.