Crie seu fluxo predefinido do zero

Aqui você aprenderá como gerar fluxos a partir de fluxos predefinidos que se ajustem às suas necessidades e agilizem a entrada em produção do seu negócio!

Criação de um fluxo predefinido

Para criar um fluxo predefinido, depois de 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, depois de entrar na área de Criar Fluxos, você deverá clicar no botão de Criar, como se indica 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 Disparador da criação do fluxo.

Ali você terá as seguintes opções para sua criação:

Modelo: onde você utilizará o modelo de WhatsApp correspondente
Webhook: onde os webhooks enlazam o evento que se produz 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 Disparador, 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 será determinado o comportamento, neste caso, dos botões ou outra ação que desenvolva as ações que necessitamos:

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 disparador 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, faça duplo clique no componente Webhook e depois em “Mostrar pedido POST” no painel direito. No detalhe do pedido 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 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 de 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 de 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 te permite copiar a URL do webhook, enquanto que o botão 2 você pode empregá-lo para copiar os campos de informação em formato JSON.

Tenha em conta a seguinte informação a respeito dos parâmetros de um webhook ATOM.

Todo webhook ATOM tem, por defeito, 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“) você deverá inseri-lo antepondo o sinal “+“ e o código de área de seu país, sem utilizar hifens ou espaços.

No entanto, se no fluxo forem inseridos modelos com seus próprios campos personalizados, todos eles passarão a ser parâmetros de entradas obrigatórios do webhook.

Por outra parte, Atom permite incluir outros parâmetros no webhook através dos campos personalizados, tal e 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, será exibido um painel onde poderá visualizar os campos requeridos.

Realize testes de 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á usada a ferramenta de testes de APIs denominada Postman.

A seguir você verá o passo a passo para simular um fluxo com webhooks em Postman:

Vá ao módulo de Campanhas.
Clique no submódulo de webhooks.

3. Dirija-se ao fluxo com webhook que deseja provar e clique no ícone URL para copiar a mesma e usá-la em Postman.

4. A seguir, complete os seguintes parâmetros em 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 outra parte, 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 de Atom que você tenha em uso.

Body

Formato: raw
Escrever os parâmetros em formato JSON, ej:

{

"phone": "5795755112756",

"client_name": "Martin Lopez"

}

Todos os parâmetros devem ser inseridos em formato string, ou seja, entre aspas duplas ( “”).

No 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 satisfactoriamente"} |

{"message":"Webhook executado satisfactoriamente"}

| Token inexistente |

Token inexistente

| 401 - Unauthorized |

401 - Unauthorized

| No authorization token found. |

No authorization token found.

| Token incorreto |

Token incorreto

| 404 - Not Found |

404 - Not Found

| Cannot find a company with uuidToken = xxxxxxx |

Cannot find a company with uuidToken = xxxxxxx

| Parâmetro requerido |

Parâmetro requerido

| 500 - Internal Server Error |

500 - Internal Server Error

| {"message": "El parametro xxxx es requerido","hasErrors": true} |

{

"message": "El parametro xxxx es requerido",

"hasErrors": true

}

| Tentar simular um fluxo ativo |

Tentar simular um fluxo ativo

| 500 - Internal Server Error |

500 - Internal Server Error

| {"message":"El contacto se encuentra simulando un flujo.","hasErrors":true} |

{

"message":"El contacto se encuentra simulando un flujo.",

"hasErrors":true

}

Define os disparadores de seu CRM ou ERP que executarão o fluxo com webhook criado. É importante que configure neles tanto a 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 produtivo seu fluxo.

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 pedido HTTP.

Para isso, será usado o componente “Pedido HTTP” no design do fluxo de trabalho. A seguir veremos sua configuração:

No editor de fluxos de trabalho de ATOM, insira o componente “Pedido HTTP”.
Como método, você deve escolher: “POST”.
Insira a URL para a qual serão enviados os dados dos campos personalizados empregados no fluxo.
Ative o campo para inserir os campos no Corpo do pedido, 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 exibirá uma lista com todos os campos de informação disponíveis para inserir.

6. Proceda a 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 “Pedido HTTP”:

Geramos um fluxo com um pedido 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 contesta o seguinte no WhatsApp:
Podemos observar como a última resposta do cliente é armazenada no campo “Identificação”:

Criar fluxo predefinido baseado nas opções disponíveis

Selecione alguma das opções que se assemelhe mais 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 será aberto com o design existente.
Tenha em conta antes de salvar o fluxo, você deve atribuir um nome diferente ao fluxo predefinido tomado como base.
No caso de você selecionar um fluxo predefinido que possua modelos ou campos personalizados que não tenham sido configurados em sua empresa, Atom notificará a ausência dos mesmos e te 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 desde a barra vertical esquerda da interface, ou no tooltip que aparece em cada componente.
Seus fluxos podem começar com um modelo ou mensagem. Por defeito, no momento de criar um fluxo personalizado, se conta o início de fluxo.
Toda ramificação de execução deve terminar em um componente de fim de fluxo.
Adicionalmente, várias ramificações podem se combinar 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 de dita conversação a um grupo ou agente em particular.

Crie seu fluxo predefinido do zero.