Criação de fluxos de campanhas no Atom
Neste artigo, mostramos como você pode criar seus fluxos de campanhas no Atom, seja criando-os do zero ou a partir de fluxos predefinidos.
No Atom, os fluxos permitem automatizar interações e processos dentro da plataforma, e neste caso, você pode utilizá-los para suas campanhas. Existem duas formas de criar um fluxo: do zero ou utilizando fluxos predefinidos. A seguir, explicamos ambas as abordagens para que você escolha a que melhor se adapte às suas necessidades.
Criação de fluxos do zero
Criação de fluxos a partir de fluxos predefinidos
Criação de fluxos do zero
Acesse a área de Criar Fluxos e selecione "Fluxos do zero".
Escolha o número do WhatsApp para o fluxo e clique em Continuar.
Na tela de criação do fluxo, selecione o gatilho adequado no painel direito: Modelo: Use um modelo de WhatsApp previamente criado para iniciar o fluxo. Webhook: Configure um evento que conecte a aplicação do servidor com o cliente.
Na tela de criação do fluxo, selecione o gatilho adequado no painel direito:
Modelo: Use um modelo de WhatsApp previamente criado para iniciar o fluxo.
Webhook: Configure um evento que conecte a aplicação do servidor com o cliente.
Inicie com Modelos:
Selecione um modelo no gatilho. Para criar seu modelo aqui mesmo, visite o seguinte artigo: Crie o modelo da sua campanha a partir do Flowbuilder/Fluxos
Use o componente "Avaliar Resposta" para definir como o bot reagirá a ações do cliente, como cliques em botões.
Utilize as ferramentas
Seção 1: botões de fazer, desfazer, slider de zoom e exportar imagem.
Seção 2: Atalhos do teclado e mini mapa de navegação do fluxo.
Seção 3: Indicador de erros no fluxo, botão de salvar, simulador de fluxos e publicar.
Criação com Webhooks:
Se você deseja integrar webhooks em seu fluxo, leia o seguinte artigo detalhado.
IMPORTANTE: Todos os fluxos têm uma duração definida pelos tempos estabelecidos nos avaliadores de resposta, mais 5 minutos adicionais para permitir que qualquer ação do bot seja concluída antes que o fluxo termine. Se a ação ocorrer após esse tempo, ela não será executada.
Criação de fluxos de campanha a partir de fluxos predefinidos
Para criar um fluxo predefinido, após entrar na área de Criar Fluxos, você deverá selecionar o botão "Fluxos predefinidos".
Em seguida, você poderá escolher a indústria e o nível de complexidade, com base no fluxo que você precisa, e poderá escolher entre alguma das opções disponíveis predefinidas, como Confirmação de Agendamento, Interesse de Veículo como se vê neste exemplo, ou criá-lo do zero.
Nos controles do fluxo predefinido, você também tem a opção de visualizar, com o ícone do olho.
Criação de um fluxo predefinido do zero
Aqui você poderá criar um fluxo predefinido do zero, onde poderá gerá-lo de acordo com suas necessidades desde o início.
Para criar um fluxo predefinido do zero, após entrar na área de Criar Fluxos, você deverá clicar no botão de Criar, como indicado a seguir:
Em seguida, será solicitado que você selecione o número de WhatsApp que terá como destino esse fluxo. Uma vez selecionado, clique em Continuar.
Em seguida, você passará para a tela de Criação do Fluxo, onde observará no painel direito da tela, o telefone selecionado e o Gatilho da criação do fluxo.
Lá terá as seguintes opções para sua criação:
Modelo: onde você utilizará o modelo de WhatsApp correspondente
Webhook: onde os webhooks ligam o evento que ocorre na aplicação do servidor e solicitam que envie a carga útil ao cliente através da web.
Criação de fluxo do zero com Modelo
💡Importante: previamente, você deverá ter seu modelo criado para poder vinculá-lo ao fluxo.
No painel direito, em Gatilho, você selecionará a opção Modelo.
Em seguida, selecionaremos o modelo:
E a partir daqui, você determinará o comportamento do bot, através do componente de Avaliar Resposta, onde se determinará o comportamento neste caso dos botões ou outra ação que desenvolva as ações que precisemos:
Se você quiser aprender mais sobre todos os componentes disponíveis para configurar seu bot, você pode visitar o seguinte artigo.
Criação de fluxo predefinido do zero com Webhook
Para criar um fluxo que contenha o suporte para webhooks, siga os seguintes passos:
No editor de fluxos de Atom, escolha a opção de gatilho Webhook.
A seguir, conecte o componente webhook com um de modelo.
Depois de escolher um modelo, você pode continuar adicionando os componentes que considerar para completar o fluxo. Para mais informações sobre os componentes de um fluxo, você pode ver este artigo.
Uma vez completado o fluxo de trabalho, copie os parâmetros de entrada do Webhook. Você pode fazê-lo de duas formas distintas:
Antes de publicar o fluxo de trabalho, clique duas vezes no componente Webhook e, em seguida, em “Mostrar solicitação POST” no painel direito. No detalhe da solicitação POST, você encontrará entre símbolos {} os parâmetros (tenha em conta que você deverá substituir os valores “Dados a enviar” pelo que corresponda”. Exemplo:
Exemplo:
Outra opção que você tem para copiar os parâmetros de entrada, uma vez que o fluxo tenha sido publicado e se encontre com o estado ‘Ativo’, são os seguintes: Selecione o fluxo com webhook na tela de ‘Webhooks’ dentro do módulo de Campanhas e execute a ação ‘Ver fluxo’:
Selecione o fluxo com webhook na tela de ‘Webhooks’ dentro do módulo de Campanhas e execute a ação ‘Ver fluxo’:
No visualizador de fluxos de trabalho, clique no botão ‘Copiar campos de informação’ que se encontra dentro do componente webhook:
No visualizador de fluxos de trabalho, clique no botão ‘Copiar campos de informação’ que se encontra dentro do componente webhook:
Os campos serão copiados com o seguinte formato, prontos para colá-los em sua ferramenta de teste de APIs ou na configuração do seu CRM que se conectará ao webhook de ATOM:
Os campos serão copiados com o seguinte formato, prontos para colá-los em sua ferramenta de teste de APIs ou na configuração do seu CRM que se conectará ao webhook de ATOM:
Exemplo:
{
"phone": "",
"company_name": "",
"fecha_cita": "",
"monto": "",
"name": ""
}
Depois de finalizar a criação do fluxo de trabalho com webhook, salve-o e publique-o para que possa utilizá-lo.
O componente webhook conta com dois botões para agilizar sua posterior operação:
O botão 1 permite copiar o URL do webhook, enquanto o botão 2 pode ser empregado para copiar os campos de informação em formato JSON.
Tenha em conta a seguinte informação acerca dos parâmetros de um webhook ATOM.
Todo webhook ATOM tem, por padrão, como parâmetro de entrada obrigatório o número de telefone (phone) de destino das mensagens do fluxo.
O número de telefone (“phone“) deverá ser inserido antepondo o sinal “+“ e o código de área do seu país, sem utilizar traços ou espaços.
No entanto, se no fluxo se inserem modelos com seus próprios campos personalizados, todos eles passarão a ser parâmetros de entradas obrigatórios do webhook.
Por outro lado, o Atom permite incluir outros parâmetros no webhook através dos campos personalizados, tal como se mostra a seguir:
Para visualizar os campos requeridos de um webhook:
Dirija-se ao editor de fluxos no módulo de Campanhas.
Clique no componente Webhook.
À direita da tela, se abrirá um painel onde poderá visualizar os campos requeridos.
Realize testes do seu fluxo
Uma vez que você tenha um fluxo com webhook criado e publicado, você pode simular e avaliar sua execução. Para isso, será utilizada a ferramenta de testes de APIs denominada Postman.
A seguir, você verá o passo a passo para simular um fluxo com webhooks no Postman:
Vá ao módulo de Campanhas.
Clique no submódulo de webhooks.
3. Dirija-se ao fluxo com webhook que você deseja testar e clique no ícone URL para copiar a mesma e usá-la no Postman.
4. A seguir, complete os seguintes parâmetros no Postman:
Headers
Content-Type: application/json
Authorization: Bearer xxxxx, sendo xxxxx o token API que deve obtê-lo no submódulo Minha Empresa → Configuração de segurança
💡Importante: ao empregar um webhook, é obrigatória a autenticação através do token API. Por outro lado, tenha em conta que se você já possui um gerado e decide gerar um novo, você tem que substituir o novo em todos aqueles webhooks e APIs do Atom que você tenha em uso.
Body
Formato: raw
Escrever os parâmetros em formato JSON, ex:
{
"phone": "5795755112756",
"client_name": "Martin Lopez"
}
Todos os parâmetros devem ser inseridos em formato string, ou seja, entre aspas duplas (“”).
Ao momento de utilizar os webhooks ATOM, você pode encontrar os seguintes códigos
| Cenário |
Cenário
| Código de Resposta |
Código de Resposta
| Corpo da Resposta |
Corpo da Resposta
| Envio satisfatório |
Envio satisfatório
| 200 - Ok |
200 - Ok
| {"message":"Webhook executado com sucesso"} |
{"message":"Webhook executado com sucesso"}
| Token inexistente |
Token inexistente
| 401 - Unauthorized |
401 - Não autorizado
| Nenhum token de autorização encontrado. |
Nenhum token de autorização encontrado.
| Token incorreto |
Token incorreto
| 404 - Não Encontrado |
404 - Não Encontrado
| Não é possível encontrar uma empresa com uuidToken = xxxxxxx |
Não é possível encontrar uma empresa com uuidToken = xxxxxxx
| Parâmetro requerido |
Parâmetro requerido
| 500 - Erro Interno do Servidor |
500 - Erro Interno do Servidor
| {"message": "O parâmetro xxxx é requerido","hasErrors": true} |
{
"message": "O parâmetro xxxx é requerido",
"hasErrors": true
}
| Tentar simular um fluxo ativo |
Tentar simular um fluxo ativo
| 500 - Erro Interno do Servidor |
500 - Erro Interno do Servidor
| {"message":"O contato se encontra simulando um fluxo.","hasErrors":true} |
{
"message":"O contato se encontra simulando um fluxo.",
"hasErrors":true
}
Defina os gatilhos do seu CRM ou ERP que executarão o fluxo com webhook criado. É importante que você configure neles tanto o URL como os parâmetros do webhook de ATOM.
Uma vez que você tenha avaliado e aprovado a interação entre seu CRM ou ERP e o webhook ATOM, coloque seu fluxo produtivo.
Emprego do componente http para devolver os dados de um fluxo
Alternativamente, você conta com a possibilidade de devolver os dados empregados em um fluxo através do método POST de solicitação HTTP.
Para isso, será utilizado o componente “Solicitação HTTP” no desenho do fluxo de trabalho. A seguir veremos sua configuração:
No editor de fluxos de trabalho de ATOM, insira o componente “Solicitação HTTP”.
Comométododeve escolher: “POST”.
Insira o URL para o qual serão enviados os dados dos campos personalizados empregados no fluxo.
Ative o campo para inserir os campos no Corpo da solicitação, deslizando o botão Corpo.
5. Os campos de informação devem ser inseridos em formato JSON. Tenha em conta que tanto o identificador do campo como seu valor (o campo de informação) devem ir entre aspas duplas (“).
Para escolher o campo de informação que captura o dado, pressione a tecla / (barra) a qual abrirá uma listagem com todos os campos de informação disponíveis para inserir.
6. Prossiga para simular a execução do fluxo para avaliar o envio dos dados.
A seguir, apresentamos um exemplo de uma simulação de um fluxo que contém um componente “Solicitação HTTP”:
Geramos um fluxo com uma solicitação HTTP com os seguintes parâmetros:
O campo “name” é um parâmetro de entrada do fluxo enquanto que o campo “identificação” captura a resposta do cliente no whatsapp
Iniciamos a simulação do fluxo através da ferramenta POSTMAN:
O cliente recebe e responde os seguintes no WhatsApp:
Podemos observar como a última resposta do cliente se armazena no campo “Identificação”:
Criar fluxo predefinido baseado nas opções disponíveis
Selecione alguma das opções que mais se assemelhe ao caso de uso que você deseja utilizar para seu fluxo, por exemplo, neste caso utilizamos o fluxo de "Agendamento de Agendamento"
Clique em USAR, e você deverá selecionar o número de WhatsApp para vincular este fluxo. Uma vez selecionado, clique em Continuar.
Uma vez que você selecione um fluxo predefinido, o editor de fluxos se abrirá com o desenho existente.
Tenha em conta que antes de salvar o fluxo, você deve atribuir um nome diferente ao fluxo predefinido tomado como base.
Caso você selecione um fluxo predefinido que possua modelos ou campos personalizados que não tenham sido configurados em sua empresa, o Atom lhe notificará a ausência dos mesmos e lhe brindará a possibilidade de criá-los de forma automática através da seguinte mensagem de advertência:
⚠️Tenha em conta:
Você pode criar os fluxos de acordo com sua conveniência, arrastando os componentes da barra vertical esquerda da interface, ou no tooltip que aparece em cada componente.
Seus fluxos podem começar com um modelo ou mensagem. Por padrão, ao momento de criar um fluxo personalizado, se conta o início do fluxo.
Toda ramificação de execução deve terminar em um componente de fim de fluxo.
Adicionalmente, várias ramificações podem ser combinadas em um mesmo componente de fim de fluxo.
Você conta com dois componentes que determinam o fim da execução do fluxo. Estes são: Fim de fluxo propriamente dito e a Atribuição desta conversação a um grupo ou agente em particular.