Automação com Integração no Tiflux
🔄 Automação com Integração no Tiflux
📍 Localização:
📂 Menu > Chatbot > Fluxos > Ações > Automação com Integração🎯 Introdução
A ação Automação com Integração foi criada para ampliar as possibilidades de uso do chatbot do Tiflux. Com ela, é possível integrar o chat com sistemas externos, garantindo:
troca de informações em tempo real,
continuidade fluida do atendimento,
eliminação da necessidade de buscar dados manualmente em outros sistemas.
Essa funcionalidade fortalece a automação de processos e melhora a experiência do usuário no atendimento.
📚 Sumário
🧾 Funcionalidades principais
🛠️ Como configurar
📤 Parâmetros enviados pelo Tiflux
📥 Comandos disponíveis para a integração
⚠️ Avisos importantes
❓ Perguntas frequentes (FAQ)
🧾 Funcionalidades principais
Conexão do chatbot com sistemas externos via requisições HTTP.
Envio de dados do chat em andamento para processamento em outros sistemas.
Recebimento de comandos externos para dar continuidade ao atendimento.
Possibilidade de definir até 3 fluxos alternativos após a integração.
Tratamento de falhas com rota personalizada para erros.
🛠️ Como configurar
Acesse o fluxo de chatbot no Tiflux.
Adicione a ação Automação com Integração.
Configure os seguintes parâmetros:
URL de chamada → Endereço externo que receberá os dados do chat.
URL de retorno → Endereço do Tiflux para receber os comandos da integração.
Fluxo → Caminho que o chatbot deve seguir (até 3 fluxos disponíveis).
Defina o comportamento em caso de falha, vinculando à opção Erro do chatbot.
📤 Parâmetros enviados pelo Tiflux
Quando o fluxo alcança a ação, o Tiflux envia uma requisição para a URL de chamada com os seguintes parâmetros:
Parâmetro
Tipo
Descrição
token
string
Token de autenticação.
chat_profile*
JSON
Perfil do usuário.
chat_id
integer
ID do chat em andamento.
message
string
Última mensagem enviada pelo usuário no chat.
Detalhes do chat_profile:
Parâmetro
Tipo
Descrição
id
integer
ID do contato.
organization_id
integer
ID da organização.
chat_id
integer
ID do chat em andamento.
name
string
Nome do contato.
string
E-mail do contato.
phone_number
string
Telefone do contato.
created_at
Date
Data de criação do contato.
updated_at
Date
Data da última atualização do contato.
📥 Comandos disponíveis para a integração
A integração externa pode enviar um comando por requisição, via POST para a URL de retorno. Os parâmetros devem estar no body da requisição em JSON.
1️⃣ Enviar mensagem
Envia uma mensagem para o usuário em atendimento.
Parâmetros:
Parâmetro
Tipo
Descrição
action*
string
Ação que deverá ser executada.
chat_id
integer
ID do chat.
message
string
Mensagem para enviar ao usuário em atendimento no chat.
Exemplo JSON:
{
"action": "send-message-whatsapp",
"message": "Mensagem a ser enviada",
"chat_id": 123456
}2️⃣ Salvar informações do contato
Salva ou atualiza dados do contato.
Parâmetros:
Parâmetro
Tipo
Descrição
action*
string
Ação que deverá ser executada.
chat_id
integer
ID do chat.
contact_info**
JSON
Informações do contato.
*A action para o comando de enviar mensagem sempre deve ser "send-message-whatsapp".
**O campo contact_info possui os seguintes parâmetros:
Parâmetro
Tipo
Descrição
name
string
Nome do contato.
string
Email do contato.
extra_params
JSON
JSON que pode conter parâmetros extras caso seja necessário.
Exemplo JSON:
{
"action": "save-contact",
"chat_id": 123456,
"contact_info": {
"name": "Nome do Contato",
"email": "[email protected]",
"extra_params": { "param1": "valor1" }
}
}3️⃣ Enviar para novo fluxo
Encaminha o atendimento para um fluxo pré-configurado.
Parâmetros:
Parâmetro
Tipo
Descrição
action
string
Ação que deverá ser executada.
chat_id
integer
ID do chat.
next_flux_token
string
Token do fluxo que foi configurado durante a criação da ação "Automação com Integração".
Exemplo JSON:
{
"action": "send-next-flux",
"chat_id": 123456,
"next_flux_token": "fluxo_token"
}⚠️ Avisos importantes
Em integrações via Gupshup, verifique se a URL está atualizada, especialmente em contas antigas.
Para integrações com o Meta, alguns clientes já estão com URLs atualizadas, mas é necessário validar caso a chamada falhe.
Apenas um comando por requisição é aceito.
❓ Perguntas Frequentes (FAQ)
O que é a Automação com Integração? É uma ação no chatbot que conecta o Tiflux a sistemas externos para envio/recebimento de dados.
Preciso de conhecimento técnico para configurar? Sim, é necessário saber configurar URLs de integração e interpretar JSON.
Quantos fluxos posso definir após a integração? Até 3 fluxos diferentes.
O que acontece se a URL estiver errada ou desatualizada? A integração não será executada e o chatbot seguirá para a rota de erro configurada.
Posso usar junto com o n8n? Sim, já existem workflows prontos no n8n do suporte para apoiar na configuração.
🔍 Palavras-chave para IA, indexação e busca
automação com integração,
chatbot Tiflux,
integração externa Tiflux,
fluxos chatbot,
enviar mensagem chatbot,
save-contact,
send-message-whatsapp,
send-next-flux,
integração Gupshup,
integração Meta,
n8n TifluxLast updated