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": "",
    "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.