Gatilho via API

🧩 Gatilho via API é o método que permite que softwares externos (seu site, ERP, n8n, RD Station, entre outros) "forcem" o início de um fluxo através de código.

Diferente do gatilho de conexão (onde o cliente chama a empresa), aqui é a empresa que chama o cliente ativamente baseada em um evento externo.

Ideal para:

☑️ Mensagens Transacionais: enviar um "Seu pedido foi aprovado!" assim que a compra ocorre no site.

☑️ Leads de Site: quando alguém preenche um formulário na Landing Page, o sistema cria o contato e já dispara o robô de qualificação imediatamente.

☑️ Reativação de Base: sistemas de CRM externos que enviam ofertas para contatos antigos.

.../api/messages/flowbuilderStart

Como configurar o Gatilho de Fluxo via API

⚡ Passo 01 - O Fluxo

Acesse o menu → FlowBuilder e desenvolva seu fluxo.

⚡ Passo 02 – A Fila

Acesse o menu Filas & Chatbot para criar ou editar uma Fila. No campo Fluxos de Automação, seleciona o fluxo desejado.

⚡ Passo 03 - A API

Faça uma chamada API:

Endpoint

https://{BACKEND_URL}/api/messages/flowbuilderStart

Método

POST

Autenticação

Bearer {seutokenaqui}

Payload

{
    "number": "554498108792",
    "queueId": "3"
  }

➡️ “number”: telefone do destinatário no formato ddi ddd numero (somente números). ➡️ “queueId”: ID da fila que está vinculada ao fluxo desejado. ##### 📌 Atenção: ao chamar essa API, o ticket será transferido para o status Aguardando.