Flow · Documentação técnica

Tudo o que o Flow faz, em detalhe técnico.

Canais, automações, IA, Kanban, API, webhooks e integrações. Para quem vai operar, integrar ou avaliar o Flow antes de contratar: o que cada recurso faz, quais eventos existem, o que dá para disparar de fora e onde estão os limites.

  • 13canais na mesma caixa de entrada
  • 4gatilhos de automação, com espera de 10 min a 30 dias
  • 900+chamadas documentadas na API REST
  • HMACwebhooks assinados com SHA-256

Começo

Visão geral

O Próximo Nível Flow é uma plataforma de atendimento e vendas omnichannel: as conversas de todos os canais chegam numa caixa de entrada única, ligadas ao contato, ao funil de vendas e às automações.

Por baixo, é uma aplicação web multi-conta com atualização em tempo real (WebSocket): mensagem nova, card movido no Kanban ou atribuição aparecem na tela de todos os atendentes sem recarregar. Envios, campanhas, transcrições e sincronizações rodam em filas de processamento em segundo plano, para que um disparo grande não trave o atendimento. Os dados ficam num banco relacional, e toda a plataforma é exposta por uma API REST com o mesmo controle de permissão da interface.

Nem todo recurso está em todos os planos. A tabela em Recursos por plano sai da mesma base de preços do site. Se um recurso desta página não aparece lá, confirme a disponibilidade com o comercial antes de contratar.

Entrada

Canais

Cada canal conectado vira uma caixa de entrada. Uma conta pode ter várias caixas do mesmo canal (por exemplo, um WhatsApp do comercial e outro do suporte), cada uma com sua equipe, seu horário e suas regras.

CanalO que funciona
WhatsApp (API oficial)Texto, mídia, áudio, documentos, templates aprovados, botões, listas, reações, grupos, chamadas de voz, origem do anúncio e modo coexistência com o app WhatsApp Business.
WhatsApp (QR Code)Conexão pelo próprio celular, sem templates e sem janela de 24 horas. Grupos, edição e exclusão de mensagens, sincronização de histórico recente.
Instagram DirectDMs, respostas e menções em stories, reações, mídia, origem do anúncio e janela de resposta de 7 dias.
Facebook MessengerVárias páginas, confirmação de entrega e leitura, mensagem de boas-vindas e bots.
TikTokMensagens diretas com texto, imagem, figurinhas, posts compartilhados e respostas em contexto.
TelegramBot ou conta Telegram Business, texto formatado, mídia e botões.
E-mailGmail, Outlook ou qualquer servidor IMAP/SMTP. Sequência inteira numa conversa, assinatura por atendente, imagens no corpo e diagnóstico da conexão.
Chat no siteWidget com a sua marca, formulário antes do chat, identificação de usuário logado, domínios permitidos, modo escuro e artigos da central de ajuda.
SMSEnvio e recebimento, várias linhas e campanhas.
VozTelefone no navegador: ligações de entrada e saída, espera, transferência, gravação opcional e histórico na mesma conversa.
Canal de APILiga qualquer sistema próprio (app, portal, plataforma sem integração nativa): entra por webhook, sai pela API.
LINE e X (Twitter)Mensagens diretas; no X, menções públicas opcionais.

WhatsApp: oficial ou QR Code

O Flow conecta o número que você já usa por dois caminhos. A escolha muda o que é permitido, não a experiência do atendente: as duas conexões caem na mesma caixa de entrada, com as mesmas automações e o mesmo Kanban.

PontoAPI oficial da MetaQR Code
ConexãoCadastro integrado com a Meta, ou credenciais do seu próprio app MetaLeitura do QR Code ou código de pareamento no celular
Iniciar conversaSó por template aprovado fora da janela de 24 horasLivre, a qualquer momento
Custo por mensagemTarifa da Meta por conversa iniciadaSem tarifa da Meta
TemplatesCriados, enviados para aprovação e sincronizados de dentro do FlowNão se aplica
GruposSimSim, com lista de membros, menções, adicionar e remover participantes
Editar e apagar enviadaEdição recebida sincronizadaEdição em até 15 minutos e apagar para todos
Chamadas de vozPelo navegador, entrada e saída, com pedido de permissão ao clientePor webphone integrado
Risco de bloqueioMenor: canal oficialMaior em disparo agressivo; use rotação de linhas e controle de velocidade

Na API oficial, as automações respeitam a janela de 24 horas: fora dela, o Flow bloqueia o envio de texto livre antes de chegar à Meta e pede um template. Contatos brasileiros não duplicam quando o WhatsApp omite o nono dígito. A tela de saúde da conta mostra o estado do número, o perfil comercial e o limite de mensagens.

Origem do lead em anúncio

Quando a conversa nasce de um anúncio de clique para o WhatsApp ou de um anúncio no Instagram, o Flow detecta e grava na conversa qual anúncio gerou o contato, o identificador do anúncio e o texto que o cliente viu. Esse dado fica disponível para filtro, automação e relatório, e é o que liga a venda fechada à campanha que a trouxe.

Operação

Caixa de entrada e atendimento

Status e prioridade

  • Aberta: precisa de atenção
  • Pendente: com o bot ou aguardando
  • Resolvida: finalizada
  • Adiada: volta sozinha na data marcada

O adiamento aceita linguagem natural (“amanhã às 15h”, “em 2 horas”, “próxima segunda”). A prioridade tem quatro níveis: urgente, alta, média e baixa, com ordenação por prioridade, tempo de espera, atividade recente ou não lidas.

Ferramentas do atendente

  • Respostas prontas com /: pessoais ou da equipe, com variáveis do contato e anexos.
  • Macros com # ou pela barra de comandos (Ctrl/Cmd + K): várias ações em um clique.
  • Notas privadas e menções com @: conversa interna dentro da conversa do cliente, que o cliente não vê.
  • Participantes: mais de um atendente na mesma conversa, para escalar a um especialista sem tirar o dono.
  • Filtros e pastas salvas: por status, caixa, atendente, equipe, etiqueta e atributos, combinando E/OU.
  • Busca por conteúdo, contato e metadados, incluindo o texto transcrito dos áudios.
  • Ações em lote: resolver, reabrir, adiar, atribuir, etiquetar e marcar como lida várias conversas de uma vez.
  • Transcrição de áudio: notas de voz viram texto na conversa, pesquisável.
  • Rascunho automático, conversas fixadas, gravador de voz, resposta citada, tradução e modo escuro.
  • Resolução automática de conversas paradas, com tempo por caixa de entrada.
  • Pesquisa de satisfação (CSAT) ao resolver, inclusive por template oficial do WhatsApp.

Distribuição de conversas

A atribuição pode ser manual ou automática. Na automática, a conversa vai para quem está online, por rodízio ou por carga atual, respeitando o limite de conversas simultâneas de cada atendente. Quando todos estão no limite, a conversa espera na fila. Cada caixa de entrada tem seu horário de atendimento (com intervalo de almoço e horário por dia da semana) e sua mensagem fora do horário.

Automações

Automações

O Flow automatiza em cinco camadas, que se combinam: regras por evento, regras com espera, automações por etapa do Kanban, mensagens programadas e campanhas. Bots e Typebot cuidam de fluxos conversacionais.

Regras: gatilhos, condições e ações

Uma regra de automação tem três partes: o evento que a dispara, as condições que precisam ser verdadeiras e as ações executadas. As condições usam operadores como “igual a”, “diferente de” e “contém”, e se combinam com E/OU.

Eventos que disparam uma regra

EventoQuando aconteceUso típico
Conversa criadaUm contato abre uma conversa nova em qualquer canalBoas-vindas, etiqueta de origem, distribuição por equipe
Conversa atualizadaMuda status, atendente, etiqueta, prioridade ou atributoAvisar o gestor, pedir avaliação ao resolver
Mensagem recebidaChega uma mensagem do clienteTriagem por palavra-chave, reabrir, priorizar
Mensagem criadaQualquer mensagem nova, inclusive da equipe e nota privadaAuditoria, fluxo interno disparado por nota

? Condições

  • Status da conversa
  • Caixa de entrada (canal)
  • Etiquetas
  • Idioma, país e navegador do contato
  • E-mail do contato
  • Atributos personalizados de contato e de conversa
  • Conteúdo da mensagem
  • Nota privada (para fluxos internos)

! Ações

  • Enviar mensagem automática
  • Atribuir atendente ou equipe
  • Atribuir ao último atendente que respondeu
  • Remover atribuição
  • Adicionar ou remover etiquetas
  • Alterar status ou prioridade
  • Enviar webhook para um sistema externo
  • Enviar a transcrição da conversa por e-mail
  • Silenciar a conversa
  • Redistribuir para atendentes online

A ação “enviar webhook” é a ponte para fora: a regra entrega o contexto da conversa para o seu CRM, ERP, planilha ou ferramenta de automação (n8n, Make, Zapier) no momento exato em que a condição foi atendida.

Regras com espera

Uma regra pode esperar antes de agir, de 10 minutos a 30 dias, enquanto uma condição de espera continuar verdadeira:

  • a conversa permanece num status escolhido;
  • o cliente não respondeu;
  • ninguém da equipe respondeu.

Dá para somar outras condições com E. Uma resposta, uma mudança de status ou uma condição que deixou de valer cancela a execução pendente, e na hora de agir o Flow confere tudo de novo antes de executar. É o que permite o follow-up “se o cliente não respondeu em 24 horas, mande isto”, sem risco de mandar para quem já respondeu.

Automações do Kanban

Cada etapa do funil tem automações próprias, que rodam quando o card entra nela:

  • Mensagem ou modelo na entrada da etapa: texto, mídia ou template aprovado. Por padrão, cada modelo vai uma única vez por card, mesmo se ele voltar à etapa; dá para liberar o reenvio a cada entrada.
  • Acompanhamento sem resposta: depois da espera configurada, envia uma mensagem para a conversa principal do card só se o contato não respondeu. Uma resposta do cliente cancela o envio.
  • Avisar a equipe: notifica os membros das equipes escolhidas e os atendentes do card, com alerta em tempo real no quadro.
  • Criação automática de card: conversas que chegam pelas caixas do funil viram card na etapa de entrada. É uma oportunidade aberta por contato e funil: uma conversa nova do mesmo contato, por outro canal, entra no card que já existe.
  • Ignorar grupos: a etapa de entrada pode não criar card para grupos de WhatsApp.
  • Prazo de checklist: tarefa do card com data limite avisa o responsável no prazo, e o aviso volta no intervalo definido enquanto ela estiver pendente.

As mensagens aceitam variáveis do contato, da conversa, da caixa, do atendente e dos atributos personalizados. Digite {{ no editor para ver a lista; {{contact.name}}, por exemplo, vira o nome do cliente no envio.

Mensagens programadas

Qualquer mensagem pode sair numa data e hora exatas, de dentro da conversa ou para um contato que ainda não tem conversa. Aceita texto, até 15 anexos e templates do WhatsApp.

  • Recorrência: diária, semanal (escolhendo os dias), mensal ou anual, com intervalo (“a cada 2 semanas”) e fim por data, por número de repetições ou nunca.
  • Status: pendente, enviada, falhou ou cancelada. Uma falha pode ser tentada de novo ou reagendada; uma enviada pode virar cópia programada para outra data.
  • Pela API: dá para programar para um telefone ou e-mail, e o Flow cria o contato na hora do envio.

Campanhas em massa

TipoCanalComo funciona
ContínuaChat no siteMensagem proativa para o visitante por URL da página, tempo na página ou evento, só no horário comercial
Envio únicoWhatsApp, SMS e Canal de APIDisparo para uma audiência escolhida, imediato ou agendado
  • Audiência por contato, por etiqueta ou pelos dois, com contagem antes do envio e sem duplicar telefone.
  • Conteúdo: texto com variação automática (spintax, {Olá|Bom dia} {amigo|parceiro}), anexos ou template aprovado com parâmetros por contato.
  • Rotação de linhas: distribui o disparo entre vários números de WhatsApp, trocando de linha a cada N mensagens.
  • Controle de velocidade com pausas entre envios, e pausa automática fora do horário comercial, no fuso de cada caixa.
  • Pausar, retomar e editar uma campanha que ainda não terminou, sem perder o progresso.
  • Acompanhamento: barra de progresso ao vivo, previsão de término, enviadas, falhas e relatório de erro para baixar.
  • Respostas caem para o atendente escolhido, na conversa que já existe com o contato.

Rotação de linhas, variação de texto e controle de velocidade reduzem o risco de bloqueio do WhatsApp. Nenhuma ferramenta elimina esse risco: a regra continua sendo disparar para quem conhece você.

Macros

Uma macro é uma sequência de ações que o atendente executa num clique: por exemplo, etiquetar “orçamento enviado”, mandar a mensagem padrão, atribuir ao vendedor sênior e mudar a prioridade. Podem ser pessoais ou da equipe. Se a conta exigir atributos obrigatórios para resolver, a macro que resolve pede esses campos antes.

Bots e Typebot

Cada caixa de entrada pode ter um bot. Enquanto ele atende, a conversa fica pendente e fora da fila humana; quando ele termina, quando a sessão expira ou quando um atendente responde, a conversa volta para a equipe automaticamente.

  • Bot por webhook: o Flow manda cada mensagem para a sua URL e você responde pela API. Serve para ligar qualquer lógica própria.
  • Typebot: conecta um fluxo do Typebot à caixa. Dispara em toda mensagem ou só por palavra-chave (contém, igual, começa com, termina com ou expressão regular). Tem palavra de encerramento, tempo de agrupamento de mensagens rápidas, intervalo entre respostas, expiração de sessão e opção de ignorar grupos ou números específicos.
  • O Typebot recebe na primeira mensagem nome, e-mail, telefone, etiquetas e atributos do contato e da conversa, além da lista de atendentes online e de equipes, para montar menus de transferência.
  • De dentro do fluxo, um marcador no texto atribui a conversa a um atendente ou equipe, sem webhook de volta. O cliente não vê o marcador.
  • Também há integração com Dialogflow.

Receitas prontas

Exemplos de como as camadas se combinam no dia a dia de vendas:

Lead que chega fora do horário

  1. GatilhoConversa criada
  2. CondiçãoCaixa = WhatsApp comercial, fora do horário de atendimento
  3. AçãoA IA atende e qualifica; de manhã, o card já está no funil com o resumo

Follow-up de orçamento sem resposta

  1. GatilhoCard entra na etapa “Proposta enviada”
  2. Espera48 horas sem resposta do contato
  3. AçãoMensagem de acompanhamento; se ele responder antes, nada é enviado

Carrinho abandonado vindo da loja

  1. GatilhoA loja chama a API de envio com o telefone do cliente
  2. CondiçãoChave de idempotência por carrinho, para não enviar duas vezes
  3. AçãoTemplate com o link do carrinho; a resposta cai na caixa do comercial

Venda fechada avisa o ERP

  1. GatilhoCard marcado como ganho no Kanban
  2. CondiçãoWebhook do Kanban assinado com segredo
  3. AçãoO ERP recebe o card, com valor e contato, e emite o pedido

IA

Inteligência artificial

Assistente que atende

O assistente de IA é configurado por caixa de entrada, com instruções, tom e o escopo do que pode responder. Ele entende texto e imagem, qualifica o contato com as perguntas que você definiu e passa a conversa para o humano com uma nota privada de resumo.

  • Público e horário: responde sempre, só no horário comercial ou só fora dele, e apenas para contatos que atendem às condições definidas. O resto vai para a fila humana.
  • Ignorar grupos e contatos ou conversas específicas.
  • Cenários: roteiros com regra de ativação e prioridade, como “coletar dados antes de transferir” ou “tratar segunda via de boleto”.
  • Ações nativas: anotar no contato, criar nota privada, etiquetar, mudar prioridade, consultar FAQ, resolver e transferir.
  • Resolução por inatividade: o assistente avalia se encerra, sempre encerra após o tempo definido (de 5 minutos a 24 horas) ou aguarda o cliente; a mensagem de encerramento é opcional.
  • Fontes citadas: quando a resposta vem de uma página pública da base, o link aparece na resposta. Cada resposta mostra quais ferramentas, cenários e fontes foram usados.
  • Exclusividade: numa caixa com bot externo ativo, o assistente não responde, para os dois não falarem ao mesmo tempo.

Base de conhecimento

  • Arquivos (PDF e outros), páginas do seu site por URL com sincronização automática, texto livre e perguntas e respostas.
  • Artigos da central de ajuda servem de base.
  • O Flow sugere novas perguntas frequentes a partir das conversas resolvidas por humanos; você revisa, edita e aprova.
  • Relatório de uso mostra quantas conversas usaram cada documento.

IA que consulta os seus sistemas

Ferramentas personalizadas ligam o assistente a qualquer API HTTPS pública, com GET POST PUT PATCH DELETE e parâmetros tipados (objetos, listas, campos aninhados). Na conversa, ele consulta o pedido no ERP, o estoque, a agenda ou o cadastro e responde com o dado real. Servidores MCP também podem ser ligados a um assistente. Uma ferramenta desativada continua salva, mas sai da execução, e o Flow avisa antes se algum cenário ativo depende dela.

Copilot do atendente

  • Sugestão de resposta a partir das instruções, FAQs e ferramentas de consulta do assistente; o atendente revisa antes de enviar.
  • Resumo de conversas longas.
  • Correção, expansão, simplificação e mudança de tom do texto.
  • Tradução de mensagens.
  • Transcrição de áudios e de gravações de chamada, com separação de quem falou.

A IA funciona com os principais provedores de modelos de linguagem do mercado. O consumo é medido em ações de IA por mês; o volume de cada plano está em Recursos por plano.

Vendas

Kanban, contatos e tarefas

Kanban de vendas

  • Vários funis, cada um com etapas próprias e uma etapa padrão. Visão em quadro ou em lista.
  • O card é ligado ao contato e a uma ou mais conversas reais; o atendente abre a conversa pelo ícone do canal no card.
  • Ficha do card: checklist com responsável e prazo, notas com anexos, ofertas com valor e moeda, atendentes, etiquetas e atributos personalizados.
  • Status comercial: aberto, ganho ou perdido. Total por etapa, separado por moeda, sem somar moedas diferentes.
  • Filtros por caixa, canal, etapa, atividade, etiqueta, prioridade, faixa de valor e período.
  • Relatórios de tempo por etapa e de desempenho do quadro, exportação e importação de CSV.
  • Mudanças aparecem em tempo real na lista de conversas e no painel do contato.
  • Visibilidade por funil: todos os atendentes do funil veem tudo, ou cada um vê só os cards em que está.
  • Itens com data podem virar evento no Google Agenda.

Contatos

  • Perfil com histórico de todos os canais, notas, etiquetas e atributos personalizados (texto, número, lista, data, caixa de seleção, link).
  • Atributos sensíveis podem ficar ocultos para papéis de acesso menor.
  • Empresas: contatos agrupados por domínio do e-mail, com histórico da empresa.
  • Importação e exportação de CSV com mapeamento de campos; a exportação neutraliza fórmulas de planilha.
  • Mesclar duplicados, etiquetar e excluir em massa; bloquear contato descarta as mensagens dele antes de abrir conversa.

Tarefas e agenda

  • Tarefas com tipo, prioridade, responsável, participantes e convidados externos, ligadas a contato, conversa e card.
  • Status pendente, em andamento, concluída ou cancelada; vencida é calculada pelo prazo. Concluir ou cancelar exige um resumo do resultado.
  • Recorrência por dia, semana, mês ou ano, até 100 repetições.
  • Aviso ao responsável no prazo, por notificação no navegador mesmo com o Flow fechado.
  • Google Agenda em duas vias, com Google Meet: o atendente cria o evento de dentro da conversa e envia horário e link ao cliente num clique.
  • Relatório de tarefas por responsável, tipo e status.

Desenvolvedores

API REST

Tudo o que a interface faz, a API faz: a interface do Flow é ela mesma cliente desta API, com as mesmas regras de permissão.

Autenticação e endereço

Cada usuário tem um token de acesso em Perfil → Token de acesso. Ele vai no cabeçalho api_access_token de toda requisição, e a chamada herda as permissões desse usuário. Para integrações, crie um usuário dedicado com o papel mínimo necessário.

Endereço base
https://app.chatproximonivel.com.br/api/v1/accounts/{account_id}/...

O account_id aparece na URL do Flow depois do login (/app/accounts/123/...). Corpo e resposta em JSON; envio de arquivo em multipart/form-data.

O acesso por token e a entrega de webhooks são liberados por conta. Antes de começar uma integração, confirme com o comercial que o recurso está ativo no seu plano.

Envio universal de mensagem

O endpoint mais usado em integração. Você informa a caixa de entrada e um identificador do destinatário (telefone, e-mail, id do contato ou id no canal). O Flow encontra ou cria o contato, reaproveita ou abre a conversa e envia texto, um anexo ou um template do WhatsApp.

POST /outbound_messages
curl -X POST "https://app.chatproximonivel.com.br/api/v1/accounts/$ACCOUNT_ID/outbound_messages" \
  -H "api_access_token: $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: carrinho-48213" \
  -d '{
    "inbox_id": 3,
    "recipient": { "phone_number": "+5511999998888", "name": "Marina" },
    "message": { "type": "text", "content": "Oi, Marina! Seu carrinho ainda está separado." }
  }'
  • 202 confirma que a mensagem entrou na fila, não que foi entregue. A entrega e a leitura chegam depois, pelos eventos de mensagem.
  • Idempotency-Key é opcional. Com ela, repetir a mesma requisição devolve a resposta original em vez de enviar de novo; a mesma chave com outro conteúdo devolve 409.
  • Template: "type": "template" com nome, idioma, categoria e parâmetros do cabeçalho e do corpo. O texto renderizado aparece na conversa e nos webhooks.
  • Mídia: "type": "media" com um anexo. Num template com cabeçalho de mídia, o arquivo pode ir na mesma requisição.
  • Programar: POST /scheduled_outbound_messages aceita o mesmo destinatário com scheduled_at, sem abrir conversa antes da hora.
Exemplo com template do WhatsApp
JSON
{
  "inbox_id": 6,
  "recipient": { "phone_number": "+5511999998888" },
  "message": {
    "type": "template",
    "template": {
      "name": "lembrete_boleto",
      "language": "pt_BR",
      "category": "UTILITY",
      "parameters": {
        "header": { "media_url": "https://seusite.com.br/boleto.pdf", "media_type": "document" },
        "body": { "1": "Marina", "2": "15/10" }
      }
    }
  }
}

O que a API cobre

Grupos de endpoints da conta e quantidade de chamadas documentadas em cada um:

  • Conversas87
  • Caixas de entrada73
  • IA (assistentes, base, cenários)72
  • Integrações66
  • Conta63
  • Kanban: cards61
  • Segurança41
  • Contatos40
  • Central de ajuda33
  • Relatórios32
  • Automações e campanhas27
  • Kanban: funis26
  • Mensagens25
  • Mensagens programadas24
  • Perfil24
  • Google Agenda e calendário25
  • MCP14
  • Equipes, atendentes, etiquetas22
  • Tarefas e tipos12
  • Bots9
  • Importação de dados8
  • Envio universal7
  • Chat interno7
  • Atributos e filtros12
  • Webhooks5
  • Respostas prontas5

Há ainda a API pública do cliente, sem token de usuário, para quem constrói o próprio chat: criar contato, abrir conversa, enviar e listar mensagens, e responder a pesquisa de satisfação.

Endpoints do Kanban mais usados

ChamadaO que faz
GET /kanban_itemsLista cards por funil, etapa, atendente ou conversa, paginado
POST /kanban_itemsCria card
POST /kanban_items/:id/move_to_stageMove o card de etapa
POST /kanban_items/:id/change_statusMarca como won, lost ou open
POST /kanban_items/:id/create_noteAdiciona nota, com anexo
POST /kanban_items/bulk_move_itemsMove vários cards de uma vez
GET /funnels/:id/stage_statsQuantidade e valor por etapa
GET /kanban_items/:id/stage_time_breakdownTempo que o card passou em cada etapa

Respostas e erros

CódigoSignificado
200 / 201Leitura ou alteração feita / criado
202Aceito e na fila (envio universal)
204Excluído, sem corpo
400 / 422Parâmetro inválido / regra de negócio não atendida (o corpo diz qual)
401 / 403Token ausente ou inválido / sem permissão para o recurso
404Recurso não existe nesta conta
409Chave de idempotência repetida com conteúdo diferente
429Limite de requisições atingido; espere e tente de novo

A especificação completa (OpenAPI 3.1) e uma coleção pronta para o Postman são entregues no onboarding técnico. Peça ao time pelo WhatsApp ou na sessão com o estrategista.

Desenvolvedores

Webhooks

Um webhook avisa o seu sistema, por POST em JSON, quando algo acontece no Flow. Cadastre em Configurações → Integrações → Webhooks ou pela API (/webhooks): URL, um nome para identificar e os eventos que interessam.

Eventos

EventoQuando é enviado
conversation_createdConversa nova, em qualquer canal
conversation_updatedMudou atributo, etiqueta, atendente ou prioridade (traz o que mudou)
conversation_status_changedAberta, pendente, resolvida ou adiada
message_createdMensagem nova, recebida ou enviada
message_updatedMudou o status de entrega ou leitura, ou a mensagem foi editada
contact_created / contact_updatedContato criado ou alterado
conversation_typing_on / _offAlguém começou ou parou de digitar
webwidget_triggeredVisitante abriu o chat do site
inbox_updatedMudança na caixa de entrada, inclusive desconexão do canal

Além desses, há eventos próprios de outros módulos:

  • Kanban: kanban.item.created e kanban.item.updated, com URL e segredo próprios na configuração do Kanban, e um botão para testar a entrega.
  • Mensagens programadas: scheduled_message.created, .updated e .deleted.
  • Bot por webhook: cada mensagem da caixa vai para a URL do bot, com tempo limite e novas tentativas configuráveis.
  • Regras de automação: a ação “enviar webhook” manda o contexto da conversa para a URL que você escolher, só quando as condições da regra batem.
Exemplo resumido de message_created
JSON
{
  "event": "message_created",
  "id": 91827,
  "content": "Oi, ainda tem o plano anual?",
  "message_type": "incoming",
  "created_at": "2026-10-13T14:02:11Z",
  "conversation": { "id": 4521, "status": "open", "inbox_id": 3 },
  "sender": { "id": 7781, "name": "Marina", "phone_number": "+5511999998888" },
  "inbox": { "id": 3, "name": "WhatsApp Comercial" },
  "account": { "id": 12, "name": "Sua empresa" }
}

Anexos chegam com o tipo do arquivo e a extensão. Os campos completos de cada evento estão na especificação entregue no onboarding técnico.

Assinatura HMAC-SHA256

Para ter certeza de que a requisição veio do Flow, cada entrega pode ser assinada. A assinatura é um HMAC-SHA256 do texto {timestamp}.{corpo bruto} com o segredo do webhook, enviada no formato sha256=<hex> junto com o carimbo de tempo, em dois cabeçalhos da requisição. Para validar:

  1. leia o corpo bruto, antes de converter para JSON;
  2. calcule o HMAC com o seu segredo e compare em tempo constante;
  3. recuse entregas com o carimbo de tempo mais velho que 5 minutos, para barrar reenvio.
Node.js: validação
const crypto = require('crypto');

function webhookValido(corpoBruto, timestamp, assinatura, segredo) {
  const esperado = 'sha256=' + crypto
    .createHmac('sha256', segredo)
    .update(`${timestamp}.${corpoBruto}`)
    .digest('hex');
  const recente = Math.abs(Date.now() / 1000 - Number(timestamp)) < 300;
  const a = Buffer.from(esperado), b = Buffer.from(String(assinatura));
  return recente && a.length === b.length && crypto.timingSafeEqual(a, b);
}

O segredo e os nomes exatos dos cabeçalhos são passados pelo time técnico na ativação da API. Responda 2xx rápido e processe em segundo plano: o webhook é um aviso, não um lugar para trabalho demorado.

Desenvolvedores

MCP para agentes de IA

Cada conta pode ter servidores MCP (Model Context Protocol) com endereço próprio. Com isso, um agente de IA externo, como o ChatGPT, o Claude ou um agente seu, opera o Flow por ferramentas prontas, sem você escrever integração.

  • Autenticação por OAuth 2.0 (com PKCE e renovação de token) ou por token estático, que pode ser trocado a qualquer momento.
  • Ferramentas com nome estável por área: conversas, contatos, caixas de entrada, central de ajuda, relatórios, Kanban, mensagens programadas, tarefas, templates, campanhas, SLA, calendário, IA, notificações e chat interno.
  • Envio de texto, mídia ou template para telefone ou e-mail, com o mesmo contrato do envio universal da API.
  • Fora do MCP: importação e exportação de dados, de propósito.
  • Você limita quais ferramentas cada servidor expõe, e pode ligar um servidor MCP a um assistente de IA do próprio Flow.

Ecossistema

Integrações

IntegraçãoO que faz
WooCommercePedidos do cliente dentro da conversa, buscados por e-mail ou telefone, e eventos da loja
ShopifyHistórico de compras e pedidos recentes do cliente
Google AgendaAgenda em duas vias com Google Meet, eventos ligados a conversa, card e tarefa
TypebotFluxos conversacionais com transferência para atendente ou equipe
DialogflowBot de linguagem natural por intenções
SlackConversas em canais do Slack, com resposta de lá ou só como alerta interno
Google TradutorTradução das mensagens recebidas, na própria conversa
Linear e NotionAbrir tarefa técnica a partir da conversa; consultar páginas internas
Templates da MetaCriar, enviar para aprovação, acompanhar e sincronizar templates sem abrir o Gerenciador de Negócios
Apps no painelQualquer sistema seu dentro da tela da conversa, por iframe, recebendo contato, conversa e atendente
n8n, Make, ZapierPor webhook + API: o Flow avisa, a ferramenta processa e responde pela API

Gestão

Relatórios

  • Conversas: volume, primeira resposta, tempo de resolução e tendência. Cada barra do gráfico abre as conversas que a compõem.
  • Atendentes, equipes e caixas: produtividade, tempo de resposta, disponibilidade, carga e horários de pico.
  • Etiquetas: frequência e tendência por classificação.
  • Satisfação: notas de 1 a 5 com comentário, por atendente, caixa e equipe.
  • IA e bots: sessões, taxa de resolução sem humano, transferências e satisfação depois do bot.
  • Chamadas: volume, atendimento, perdidas, duração e gravações.
  • Kanban e tarefas: tempo por etapa, valor por etapa, tarefas por status e responsável.
  • SLA: cumprimento de primeira resposta, próxima resposta e resolução.
  • Exportação em CSV compatível com Excel (UTF-8 e separador ponto e vírgula).

Controle

Equipe, permissões e segurança

Papéis e permissões

  • Papéis de administrador e atendente, e funções personalizadas com permissão por área: conversas (todas, não atribuídas ou só as suas), contatos, empresas, relatórios, campanhas, central de ajuda, Kanban, tarefas, calendário e dados sensíveis como telefone.
  • Acesso por caixa de entrada: o atendente só vê os canais em que está.
  • Equipes (vendas, suporte, financeiro) com distribuição interna e identificação por ícone e cor.
  • SLA com prazos de primeira resposta, próxima resposta e resolução, contados no horário útil da caixa.
  • Atributos obrigatórios para resolver uma conversa, para o dado não ficar para trás.
  • Desligamento de atendente com revisão das conversas dele e reatribuição em lote.

Segurança

  • Autenticação em dois fatores e login único corporativo (SAML 2.0: Okta, Microsoft Entra ID, Google Workspace e outros).
  • Registro de auditoria: quem fez o quê e quando, com filtro por tipo, período e usuário. Exclusões de mensagem guardam evidência.
  • Sessões por navegador com nome, limite de sessões simultâneas e saída que revoga o acesso daquele navegador.
  • HTTPS obrigatório, criptografia em repouso e backups automáticos.
  • Exclusão e portabilidade de dados para atender à LGPD.
  • Mensagem apagada pode continuar visível para a equipe e nunca para o cliente; o retorno ao cliente leva só o aviso de exclusão.

Além do atendimento

Central de ajuda, chat interno e app

Central de ajuda

Portais de conhecimento com domínio próprio, várias línguas, categorias, rascunho e publicação por idioma, vídeo e tabela no editor, e análise por Google Analytics 4, Tag Manager, Meta Pixel, Clarity, Hotjar e outros. Os artigos aparecem no chat do site, servem de base para a IA e podem ser inseridos na conversa pelo atendente. A IA gera rascunhos de perguntas frequentes a partir de um PDF.

Chat interno da equipe

Canais públicos e privados, mensagens diretas, categorias, respostas em linha (thread), reações, mensagens fixadas, enquetes, rascunhos e busca, sem sair do Flow. Chamadas internas de áudio e vídeo com compartilhamento de tela, para pequenos grupos.

Aplicativo

O Flow se instala como aplicativo no celular e no computador direto do navegador (PWA), em tela cheia. Notificações chegam mesmo com o app fechado, empilhadas por conversa, com resposta rápida e “marcar como lida” na própria notificação, som configurável e contador de não lidas no ícone.

Contratação

Recursos por plano

Os mesmos dados da seção de planos da página do Flow. Todo plano começa com 14 dias grátis, sem cartão.

Recursos do Próximo Nível Flow por plano
RecursoStarterProEnterprise
Plano mensalR$ 99R$ 299R$ 599
Plano anualR$ 1.069,20R$ 3.049,80R$ 5.750,40
Agentes5810
Caixas de entrada135
AI Actions por mês—2550
WhatsApp
Instagram—
Facebook—
Telegram—
E-mail—
Chat no site
SMS—
Voz—
Capitão AI——
Assistente de IA—
Ações do assistente de IA—
Kanban—
Campanhas—
Automações
Mensagens agendadas
Tarefas
Google Calendar—
WooCommerce—
SLA

Precisa de mais atendentes, mais caixas ou de um recurso que não aparece aqui? A configuração acima do Enterprise é feita sob consulta.

Dúvidas

Perguntas técnicas

O Flow tem API?

Tem, REST, com token por usuário e as mesmas permissões da interface. Cobre conversas, mensagens, contatos, caixas de entrada, equipes, etiquetas, automações, campanhas, Kanban, mensagens programadas, tarefas, relatórios e a IA. Veja API REST.

Tem webhook? Quais eventos?

Tem. Conversa criada, atualizada e com status alterado; mensagem criada e atualizada; contato criado e atualizado; digitação; abertura do chat do site; mudança de caixa. O Kanban e as mensagens programadas têm eventos próprios. Lista completa em Eventos.

Consigo disparar mensagem a partir do meu sistema?

Sim, pelo envio universal: uma requisição com o telefone ou e-mail do cliente, e o Flow cria contato e conversa sozinho. Com chave de idempotência, uma nova tentativa não duplica o envio.

Integra com o meu CRM ou ERP?

Sim. Pelo webhook o seu sistema fica sabendo do que acontece no Flow; pela API ele cria contato, move card no Kanban, marca venda ganha ou envia mensagem. Se o sistema tem API, a IA também pode consultá-lo durante a conversa, por ferramentas personalizadas.

Automação manda mensagem fora da janela de 24 horas do WhatsApp?

Na API oficial, só com template aprovado: fora da janela, o Flow bloqueia o texto livre antes do envio. Na conexão por QR Code não existe janela.

Como evito mensagem duplicada em automação?

As automações do Kanban enviam cada modelo uma vez por card, o acompanhamento sem resposta cancela se o cliente respondeu, a campanha não envia duas vezes para o mesmo telefone e o envio pela API aceita chave de idempotência.

Quando a IA passa para o humano?

Quando o cenário manda transferir, quando o cliente pede, quando a pergunta sai do escopo definido, ou quando a conversa não atende ao público e ao horário configurados. A transferência leva uma nota privada com o resumo.

Ficou alguma dúvida técnica?

Teste o Flow por 14 dias sem cartão, ou agende uma conversa com um estrategista para validar a sua integração antes de contratar.