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.
| Canal | O 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 Direct | DMs, respostas e menções em stories, reações, mídia, origem do anúncio e janela de resposta de 7 dias. |
| Facebook Messenger | Várias páginas, confirmação de entrega e leitura, mensagem de boas-vindas e bots. |
| TikTok | Mensagens diretas com texto, imagem, figurinhas, posts compartilhados e respostas em contexto. |
| Telegram | Bot ou conta Telegram Business, texto formatado, mídia e botões. |
| Gmail, 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 site | Widget 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. |
| SMS | Envio e recebimento, várias linhas e campanhas. |
| Voz | Telefone no navegador: ligações de entrada e saída, espera, transferência, gravação opcional e histórico na mesma conversa. |
| Canal de API | Liga 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.
| Ponto | API oficial da Meta | QR Code |
|---|---|---|
| Conexão | Cadastro integrado com a Meta, ou credenciais do seu próprio app Meta | Leitura do QR Code ou código de pareamento no celular |
| Iniciar conversa | Só por template aprovado fora da janela de 24 horas | Livre, a qualquer momento |
| Custo por mensagem | Tarifa da Meta por conversa iniciada | Sem tarifa da Meta |
| Templates | Criados, enviados para aprovação e sincronizados de dentro do Flow | Não se aplica |
| Grupos | Sim | Sim, com lista de membros, menções, adicionar e remover participantes |
| Editar e apagar enviada | Edição recebida sincronizada | Edição em até 15 minutos e apagar para todos |
| Chamadas de voz | Pelo navegador, entrada e saída, com pedido de permissão ao cliente | Por webphone integrado |
| Risco de bloqueio | Menor: canal oficial | Maior 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
| Evento | Quando acontece | Uso típico |
|---|---|---|
| Conversa criada | Um contato abre uma conversa nova em qualquer canal | Boas-vindas, etiqueta de origem, distribuição por equipe |
| Conversa atualizada | Muda status, atendente, etiqueta, prioridade ou atributo | Avisar o gestor, pedir avaliação ao resolver |
| Mensagem recebida | Chega uma mensagem do cliente | Triagem por palavra-chave, reabrir, priorizar |
| Mensagem criada | Qualquer mensagem nova, inclusive da equipe e nota privada | Auditoria, 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
| Tipo | Canal | Como funciona |
|---|---|---|
| Contínua | Chat no site | Mensagem proativa para o visitante por URL da página, tempo na página ou evento, só no horário comercial |
| Envio único | WhatsApp, SMS e Canal de API | Disparo 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
- GatilhoConversa criada
- CondiçãoCaixa = WhatsApp comercial, fora do horário de atendimento
- AçãoA IA atende e qualifica; de manhã, o card já está no funil com o resumo
Follow-up de orçamento sem resposta
- GatilhoCard entra na etapa “Proposta enviada”
- Espera48 horas sem resposta do contato
- AçãoMensagem de acompanhamento; se ele responder antes, nada é enviado
Carrinho abandonado vindo da loja
- GatilhoA loja chama a API de envio com o telefone do cliente
- CondiçãoChave de idempotência por carrinho, para não enviar duas vezes
- AçãoTemplate com o link do carrinho; a resposta cai na caixa do comercial
Venda fechada avisa o ERP
- GatilhoCard marcado como ganho no Kanban
- CondiçãoWebhook do Kanban assinado com segredo
- 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.
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.
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." }
}'const resposta = await fetch(
`https://app.chatproximonivel.com.br/api/v1/accounts/${ACCOUNT_ID}/outbound_messages`,
{
method: 'POST',
headers: {
'api_access_token': process.env.FLOW_TOKEN,
'Content-Type': 'application/json',
'Idempotency-Key': 'carrinho-48213'
},
body: JSON.stringify({
inbox_id: 3,
recipient: { phone_number: '+5511999998888', name: 'Marina' },
message: { type: 'text', content: 'Oi, Marina! Seu carrinho ainda está separado.' }
})
}
);
// 202: aceito e na fila. A entrega segue nos webhooks de mensagem.
console.log(resposta.status);import os, requests
r = requests.post(
f"https://app.chatproximonivel.com.br/api/v1/accounts/{ACCOUNT_ID}/outbound_messages",
headers={
"api_access_token": os.environ["FLOW_TOKEN"],
"Idempotency-Key": "carrinho-48213",
},
json={
"inbox_id": 3,
"recipient": {"phone_number": "+5511999998888", "name": "Marina"},
"message": {"type": "text", "content": "Oi, Marina! Seu carrinho ainda está separado."},
},
)
print(r.status_code) # 202: aceito e na fila202confirma 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 devolve409.- 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_messagesaceita o mesmo destinatário comscheduled_at, sem abrir conversa antes da hora.
Exemplo com template do WhatsApp
{
"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
| Chamada | O que faz |
|---|---|
GET /kanban_items | Lista cards por funil, etapa, atendente ou conversa, paginado |
POST /kanban_items | Cria card |
POST /kanban_items/:id/move_to_stage | Move o card de etapa |
POST /kanban_items/:id/change_status | Marca como won, lost ou open |
POST /kanban_items/:id/create_note | Adiciona nota, com anexo |
POST /kanban_items/bulk_move_items | Move vários cards de uma vez |
GET /funnels/:id/stage_stats | Quantidade e valor por etapa |
GET /kanban_items/:id/stage_time_breakdown | Tempo que o card passou em cada etapa |
Respostas e erros
| Código | Significado |
|---|---|
200 / 201 | Leitura ou alteração feita / criado |
202 | Aceito e na fila (envio universal) |
204 | Excluído, sem corpo |
400 / 422 | Parâmetro inválido / regra de negócio não atendida (o corpo diz qual) |
401 / 403 | Token ausente ou inválido / sem permissão para o recurso |
404 | Recurso não existe nesta conta |
409 | Chave de idempotência repetida com conteúdo diferente |
429 | Limite 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
| Evento | Quando é enviado |
|---|---|
conversation_created | Conversa nova, em qualquer canal |
conversation_updated | Mudou atributo, etiqueta, atendente ou prioridade (traz o que mudou) |
conversation_status_changed | Aberta, pendente, resolvida ou adiada |
message_created | Mensagem nova, recebida ou enviada |
message_updated | Mudou o status de entrega ou leitura, ou a mensagem foi editada |
contact_created / contact_updated | Contato criado ou alterado |
conversation_typing_on / _off | Alguém começou ou parou de digitar |
webwidget_triggered | Visitante abriu o chat do site |
inbox_updated | Mudança na caixa de entrada, inclusive desconexão do canal |
Além desses, há eventos próprios de outros módulos:
- Kanban:
kanban.item.createdekanban.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,.updatede.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
{
"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:
- leia o corpo bruto, antes de converter para JSON;
- calcule o HMAC com o seu segredo e compare em tempo constante;
- recuse entregas com o carimbo de tempo mais velho que 5 minutos, para barrar reenvio.
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ção | O que faz |
|---|---|
| WooCommerce | Pedidos do cliente dentro da conversa, buscados por e-mail ou telefone, e eventos da loja |
| Shopify | Histórico de compras e pedidos recentes do cliente |
| Google Agenda | Agenda em duas vias com Google Meet, eventos ligados a conversa, card e tarefa |
| Typebot | Fluxos conversacionais com transferência para atendente ou equipe |
| Dialogflow | Bot de linguagem natural por intenções |
| Slack | Conversas em canais do Slack, com resposta de lá ou só como alerta interno |
| Google Tradutor | Tradução das mensagens recebidas, na própria conversa |
| Linear e Notion | Abrir tarefa técnica a partir da conversa; consultar páginas internas |
| Templates da Meta | Criar, enviar para aprovação, acompanhar e sincronizar templates sem abrir o Gerenciador de Negócios |
| Apps no painel | Qualquer sistema seu dentro da tela da conversa, por iframe, recebendo contato, conversa e atendente |
| n8n, Make, Zapier | Por 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.
| Recurso | Starter | Pro | Enterprise |
|---|---|---|---|
| Plano mensal | R$ 99 | R$ 299 | R$ 599 |
| Plano anual | R$ 1.069,20 | R$ 3.049,80 | R$ 5.750,40 |
| Agentes | 5 | 8 | 10 |
| Caixas de entrada | 1 | 3 | 5 |
| AI Actions por mês | — | 25 | 50 |
| — | |||
| — | |||
| Telegram | — | ||
| — | |||
| 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.