Integração com Zapier

A Tallos desenvolveu um aplicativo (Tallos v1.0.0), integrado à plataforma Zapier, a fim de encurtar e flexibilizar a comunicação de nossos clientes com os seus clientes. A seguir são apresentados os primeiros passos para utilização do aplicativo. 

1. Autenticação 

A versão 1.0.0 possui autenticação utilizando um token que é gerado na própria plataforma. O caminho, dentro da plataforma Tallos, para gerar o token é: 

● Caminho: Integrações > Canais de Comunicação > Configurações da API > Gerar Token 

Figura 01 - Token na Plataforma Tallos

Um token de acesso é gerado ao clicar em “Gerar Token”. Esse token deve ser usado para fazer a autenticação dentro do app Tallos v.1.0.0, como na imagem abaixo. 

Figura 02 - Incluir token no Zapier 

Após esse procedimento o usuário já estará autenticado e pronto para utilizar os serviços do aplicativo. As ações atuais que o aplicativo possui, na versão 1.0.0, serão apresentadas na próxima sessão. 

2. Action Event: Integrando com o Zapier 

A versão 1.0.0 do aplicativo Tallos executa duas ações: Criação de um Contato no WhatsApp Business API (Whatsapp Oficial) e Envio de Mensagem Template. Após escolher seu primeiro app para integração (Trigger) é necessário escolher o app que executará uma ação posterior. As ações que o app Tallos v1.0.0 disponibiliza serão apresentadas a seguir:

a. Criação de um Contato no WhatsApp Oficial 

Após clicar em “+” e escolher o app Tallos v1.0.0, é apresentada uma tela onde o usuário escolhe qual ação deseja realizar. Nesse caso, foi escolhida a opção de Criar Contato. 

Figura 03 - Tela para escolher qual ação utilizar 

Na tela seguinte é solicitado que o usuário faça login. Nesse caso, como dito no tópico anterior, devemos gerar um token e colocar onde é solicitado. Após incluir o token, é só escolher a conta atualmente conectada. Obs: a autenticação só é necessária uma única vez.

Figura 04 - Fazer login (token) 

Após concluir o login, o usuário deve clicar em “continue” para ir ao próximo passo. 

Figura 05 - Usuario autenticado 

O próximo passo é preencher os campos com as informações recebidas do Trigger (primeiro app) ou informações fixas. A seguir é apresentada a tela com todas as informações necessárias.

Figura 06 - Informações para criar contato 

O detalhamento de cada campo será mostrado a seguir. Será utilizado um app em Trigger para exemplificar. 

● Nome (obrigatório): insira o nome do contato. Nesse caso, é possível digitar um nome fixo (como mostrado em 1, na imagem a seguir) ou nome variável (como em 2). Caso a variável que o usuário precisa não esteja disponível entre as três primeiras, o usuário deverá ver todas as opções (mostrado em 3).

Figura 07 - Campo nome 

É possível incluir duas variáveis em um mesmo campo, como exemplificado abaixo. No exemplo, é mostrado como fazer a junção de duas variáveis (nome e sobrenome) com um espaço em branco no meio. O resultado esperado é “Teste da Silva”. 

Figura 08 - Incluindo mais de uma variável

● Telefone (obrigatório): insira o telefone para contato. O telefone precisará estar no formato ddd+número do telefone, por exemplo: 85998765432. O número no formato 5585998765432 também é válido. 

Figura 09 - Incluindo telefone 

● Integração (obrigatório): insira o nome da integração onde o contato será salvo. O aplicativo lista as integrações disponíveis para que o usuário possa escolher (mostrado em 1), assim como o usuário poderá inserir manualmente (mostrado em 2). 

Figura 10 - Incluindo mais de uma variável

● Email (opcional): insira o email do contato. É possível incluir o email como uma variável (mostrado em 1) ou digitado manualmente (mostrado em 2). 

Figura 11 - Incluindo email 

● CPF (opcional): insira o cpf do contato. É possível incluir o cpf do contato que deseja cadastrar por meio de variável ou manualmente. obs: o Trigger (primeiro app) que está sendo usado como exemplo, não disponibiliza uma variável para cpf, mas disponibiliza um campo “description” que tem essa informação. Iremos usar a descrição no próximo tópico. 

Figura 12 - Incluindo CPF

● Descrição (opcional): insira uma descrição para o contato. É possível incluir uma descrição mais detalhada caso o usuário precise de mais informações para o contato. 

Figura 13 - Incluindo Descrição 

● Tags (opcional): insira etiquetas para o contato. É possível incluir etiquetas para identificar e categorizar o contato. As etiquetas são separadas por vírgula (,) como mostrado na imagem a seguir. No exemplo, podemos juntar tags oriundas de uma variável com tags que podem ser digitadas manualmente. 

Figura 14 - Incluindo etiquetas 

Após finalizar a configuração dos campos, o usuário deverá clicar em “continue” para avançar para a última etapa: teste de ação (Test Action).

A etapa de teste irá executar a ação de criar um contato de acordo com as informações que foram repassadas. Existe uma opção para pular o teste, mas é importante realizá-lo para verificar se todas as informações estão corretas. 

Figura 15 - Executando o teste 

Após o teste ser realizado com sucesso, o botão “Turn on Zap” ficará disponível para que o usuário possa ativar a integração. Lembrando que, se já existir um contato cadastrado com o mesmo número, o teste irá falhar.

Figura 16 - Teste finalizado 

A imagem abaixo mostra o contato que foi cadastrado após a realização do teste. 

Figura 17 - Contato que foi cadastrado no teste

Ao clicar no botão “Turn on Zap”, a integração ficará online e funcional. 

Figura 18 - Zap ativo 

É possível notar que, após a ação “Criar Contato”, o Zapier disponibiliza um botão “+” para incluir uma outra ação. A seguir, vamos incluir outra ação: enviar mensagem template. 

b. Enviar Mensagem Template 

O app Tallos v1.0.0 disponibiliza uma ação para enviar mensagem template para um contato já cadastrado. Essa funcionalidade é bastante utilizada em conjunto com a funcionalidade anterior. A seguir, será apresentada uma explicação de como configurar a ação de enviar mensagem template. 

Primeiramente, o usuário deverá clicar na opção “+” e escolher a ação “Enviar Mensagem Template”, como indica a imagem abaixo.

Figura 19 - Escolher a ação de enviar mensagem template 

Ao clicar em continuar, o usuário será direcionado a tela de contas. É disponibilizada a opção de conectar uma outra conta Tallos ou escolher a que já foi conectada anteriormente. Nesse exemplo, foi escolhida a conta que já foi autenticada anteriormente. 

Figura 20 - Escolher a conta

O próximo passo é configurar a ação. A imagem a seguir apresenta os três campos de configuração obrigatórios: ID, Mensagem Template e Mensagem. 

Figura 21 - Configuração ação 

Cada campo mostrado na imagem acima será detalhado adiante. 

● ID (obrigatório): insira ID do contato cadastrado. É necessário incluir o ID do contato que está, ou que foi, cadastrado na plataforma Tallos. Será utilizado o ID do contato cadastrado na ação anterior (Criação de um Contato no WhatsApp Oficial), como mostra a imagem abaixo.

Figura 22 - ID do contato 

Note que são disponibilizadas variáveis tanto do Trigger (primeiro app), mostrado em 1, quanto da ação anterior (Tallos: Criar Contato). 

● Mensagem Template (obrigatório): insira a mensagem template cadastrada. É necessário incluir qual mensagem template será enviada para o contato. Será escolhida a primeira mensagem template listada, conforme a imagem abaixo, mas é possível digitar manualmente (mostrado em 1).

Figura 23 - Mensagem Template 

● Mensagem (obrigatório): insira a mensagem que será enviada. É necessário incluir a mensagem que será enviada ao contato. É obrigatório que a Mensagem seja idêntica a Mensagem Template, mudando apenas a variável se houver. 

Figura 24 - Configuração de mensagem

Neste exemplo, a variável @PRIMEIRONOME da Mensagem Template foi substituída pela variável “Nome”, oriunda da ação anterior (Cadastrar Contato). Ao final, a mensagem que será enviada para o contato será: “Por falta de comunicação, encerrarei o Teste da Silva. Qualquer dúvida, estaremos a disposição.” 

Após finalizar a configuração, o usuário é direcionado para a etapa final: teste de ação. A imagem a seguir apresenta a tela de teste. Ao clicar em “Test & Continue”, uma mensagem será enviada para o contato de acordo com as configurações estabelecidas. 

Figura 25 - Teste de ação 

A imagem a seguir mostra o resultado do teste: a mensagem foi enviada com sucesso para o contato que foi cadastrado. 

Figura 26 - Resultado do Teste

Após o teste ser finalizado com sucesso, resta apenas clicar no botão “Turn on Zap” para que a integração fique ativa. 

Figura 26 - Turn on Zap 

3. Conclusão 

Ao final desta leitura, será possível criar uma integração entre aplicativos utilizando as ações disponíveis no app Tallos v1.0.0.


Como fomos?

Powered by HelpDocs (opens in a new tab)