O Tiflux é um sistema para a gestão de fluxos de tickets e atendimento, com o qual é possível adotar uma estratégia omnichannel com canais customizáveis, ter acesso a um painel completo para visualizar as tarefas, e ainda ter a opção de aderir a canais invisíveis para gerar os tickets internamente.
Com a integração entre Tiflux e Atendare você pode ao realizar uma ação, por exemplo, ganhar uma negociação enviar dados automaticamente para o Tiflux, para gerenciar seu fluxo de tickets, atendimentos e serviços.
REQUISITOS
- Ter uma conta ativa no Atendare
- Ter o evento de Automação Webhook contratado na sua conta do Atendare
- Ter uma conta no Tiflux
- Ter uma conta no Make
TÓPICOS DO ARTIGO
OBJETIVO DA INTEGRAÇÃO
Esta integração tem a finalidade de enviar as informações de negociação e empresa do Atendare para o Tiflux, com o intuito de criar um registro de cliente no Tiflux.
Esse envio é feito de forma automática, através de uma automação no Atendare. O gatilho para executar a integração é quando uma negociação é ganha.
CONFIGURANDO A INTEGRAÇÃO
1. Realize o login no sua conta do Make e clique em Create a new scenario:
2. Em seguida realize a adição do módulo do Webhook > Custom a webhook:
3. Em seguida clique em Add e escolha um nome de sua preferência para seu evento de Webhook:
Atenção! O link gerado pelo Webhook será utilizado no evento da automação do Atendare
4. Agora entre no Atendare e vá até as automações. Na tela de automações crie uma automação de negociação.
Saiba mais sobre como criar automações e as suas utilidades nesta seção de artigos.
5. Após criar a automação, selecione a engrenagem sobre o evento de início e depois clique no gatilho Ganhar negociação.
Com isso, a automação será iniciada sempre que uma negociação for ganha.
6. Após selecionar o gatilho, será necessário configurá-lo. Aqui você pode escolher qual ou quais pipelines estarão participando deste evento.
7. Agora vamos criar o evento que vai enviar as informações para o Make. Para isso, selecione uma das setas laterais do gatilho inicial e clique ou arraste.
Depois disso, selecione o evento Webhook.
8. Insira o link gerado pelo Make no campo Url do evento.
9. E para finalizar essa parte do processo no Atendare, basta clicar no botão Ativar no canto superior direito da tela.
Pronto! A etapa da integração dentro do Atendare está finalizada, agora vamos voltar para o Make.
10. No Make, clique em Run once para testar se ele está recebendo as informações do Atendare.
Essa etapa é muito importante, pois é aqui que o Make vai identificar o nome das variáveis que o Atendare utiliza. Essa informação será muito útil mais pra frente.
DICA 1: Para testar essa etapa, será necessário marcar uma negociação como ganha. Sugerimos que você crie uma negociação de teste, com dados fictícios.
DICA 2: Sempre salve as suas alterações no Make (botão na barra inferior) pois ele não salva sozinho.
Quando o Make terminar de realizar o teste, o seu módulo deverá ficar assim:
11. Agora vamos conectar um novo módulo ao Webhooks. O módulo que iremos integrar é o HTTP > Make a Request:
12. A configuração deste módulo irá realizar a busca da negociação dentro do Atendare:
A variável payload: id estará disponível para você utilizar pois anteriormente foi realizado o teste do Webhook (passo 10).
13. Realize um novo envio de teste clicando em Run once. Isso é importante para que o Make entenda o nome das variáveis utilizadas pelo Atendare, e também para verificar se há algum erro no processo até o momento.
14. Agora, vamos adicionar um novo módulo HTTP > Make a Request que irá realizar a busca da empresa dentro do Atendare.
15. Realize um teste. Outra forma de realizar o teste é clicando com o botão direito sobre o módulo gerado e clicando em Run this module only.
É importante que todos os parâmetros que serão obrigatórios no Tiflux não estejam vazios.
16. Antes de prosseguir, vá em sua conta do Tiflux para criar o seu link de integração (vamos chamá-lo de token Tiflux).
Você pode aprender como fazer esse processo pelo lado do Tiflux lendo esses dois artigos deles:
- Como utilizar a API do Tiflux – Aqui você vai aprender a gerar o seu usuário e senha de API. Essa informação será necessária para o próximo artigo.
- Link da API aberta do Tiflux – Aqui você vai aprender o processo para gerar o seu token de acesso no Tiflux, para isso você irá utilizar o usuário e senha que foi comentado antes. Além disso, neste conteúdo você pode aprender a como configurar as requisições desejadas. Por exemplo, aqui você pode descobrir qual é a forma de criar contatos, tickets, clientes, entre outros, via API.
Atenção: se tiver alguma dificuldade nesta etapa do processo, entre em contato conosco pelo [email protected] que iremos te ajudar.
Após criar o seu link de integração (token Tiflux) podemos prosseguir.
No exemplo deste tutorial, vamos estar criando a integração para gerar um registro de novo cliente automaticamente no Tiflux cada vez que uma negociação for ganha no Atendare.
17. Voltando para o Make, vamos continuar o processo de criação da integração. Agora vamos adicionar um módulo HTTP > Make a Request que irá realizar o envio dos dados da empresa para o Tiflux.
18. Nessa etapa, você deverá configurar os campos do Tiflux com os campos do Atendare correspondente as empresas:
Para facilitar a sua integração, segue o código transcrito abaixo, não esqueça de trocar as palavras em negrito pelas variáveis correspondentes no Make:
{
"name":"data: data: name",
"social":"data: data: company: full_name",
"social_revenue":"data: data: company: document",
"id":"data: data: id",
"cep":"Data.data.addresses[]: postal_code"
}
19. Realize um novo envio de teste clicando em Run once. Isso é importante para que o Make agora entenda o nome das variáveis utilizadas pelo Tiflux, e também para verificar se há algum erro no processo até o momento.
20. Agora vamos adicionar um módulo HTTP > Make a Request que irá realizar o envio dos dados de endereço para o Tiflux:
21. E depois de adicionar o módulo, vamos colocar o link da api e o token de integração:
22. Nessa etapa, você deverá mapear novamente os campos do Tiflux com o Atendare correspondente ao endereço:
Para facilitar a sua integração, segue o código transcrito abaixo, não esqueça de trocar as palavras em negrito pelas variáveis correspondentes no Make:
{
"cep":"data.data.addresses[].postal_code",
"city":"data.data.addresses[].city",
"state":"data.data.addresses[].state",
"neighborhood": "data.data.addresses[].neighborhood",
"street": "data.data.addresses[].street",
"number": data.data.addresses[].number
}Lembre-se de enviar as informações de todos os campos obrigatórios.
Dica: O campo “state” do Tiflux aceita apenas o UF, ou seja, duas letras. Portanto, certifique-se que o cadastro de endereço da empresa no Atendare contenha o UF do estado, e não o nome completo do estado.
23. Realizando o mesmo processo, agora vamos adicionar um módulo HTTP > Make a Request que irá realizar o envio dos dados de contato da empresa para o Tiflux.
24. E então, realizar novamente o mapeamento dos campos correspondente a criação do contato:
Para facilitar a sua integração, segue o código transcrito abaixo, não esqueça de trocar as palavras em negrito pelas variáveis correspondentes no Make:
{
"owner":"data.data.contacts[].name",
"email":"data.data.contacts[].email",
"number":"data.data.contacts[].phone",
"use":0
}
E pronto! Dessa forma seu cenário de integração está pronto!
ATIVANDO O CENÁRIO
Para ativar seu cenário, selecione a opção ON no canto inferior esquerdo:
Ficou com alguma dúvida? Envie um e-mail para [email protected] que vamos te ajudar!