Recurso em beta: pode mudar. Versão beta, em fase de testes. Os gatilhos, limites e proteções comuns estão na visão geral dos bots.
Situação: versão beta, em fase de testes.
O Dify monta aplicativos de IA com base de conhecimento; o Flowise monta fluxos de agentes em blocos. Em comum, os dois recebem a pergunta, devolvem texto e guardam a conversa por contato. Escolha o Dify quando o conteúdo é o centro (perguntas e respostas sobre catálogo, política, documentação); escolha o Flowise quando o agente precisa de várias etapas e ferramentas desenhadas por você; para um roteiro de perguntas, o Typebot; para um modelo simples com instruções, o bot de IA.
Como ligo um app do Dify?
O que preciso para o Dify?
- Um aplicativo do tipo Chatbot ou Chatflow publicado no Dify.
- A chave de API do aplicativo (cada app tem a sua), na área de acesso à API.
- Uma instância conectada e a chave.
Como configuro o Dify?
curl -X PUT "https://proxybox.com.br/api/whatsapp/v1/integrations/bot" \
-H "apikey: SUA_CHAVE" -H "Content-Type: application/json" \
-d '{
"type": "dify",
"enabled": true,
"url": "https://api.dify.ai/v1",
"api_key": "app-XXXXXXXXXXXX",
"trigger": "all",
"ignore_groups": true,
"delay_seconds": 2,
"stop_on_human_minutes": 30
}'
Se o campo url ficar vazio, vale https://api.dify.ai/v1. A chave vai no cabeçalho Authorization: Bearer. Ela é guardada cifrada e nunca volta inteira nas respostas.
O que a ProxyBox envia ao Dify?
Um POST {url}/chat-messages com:
{
"inputs": {},
"query": "Qual o prazo de entrega para Joinville?",
"response_mode": "blocking",
"conversation_id": "ID_GUARDADO_PARA_ESTE_CONTATO",
"user": "5547999999999"
}
queryé o texto da pessoa (ou do lote, se você usa o agrupamento);useridentifica o contato (o telefone), o que permite ao Dify agrupar histórico e métricas por pessoa;conversation_idsó vai a partir da segunda mensagem; a ProxyBox o recebe na primeira resposta e guarda por contato, em lugar cifrado;- a resposta usada é
answer.
Se o Dify devolver 404 para o conversation_id (conversa apagada), a ProxyBox recomeça a conversa daquele contato.
Como é a resposta do Dify no WhatsApp?
O texto do answer é enviado como mensagem, dividido em partes de até 1.500 caracteres se for longo, com pausa de 1 segundo. Formatação em markdown do Dify (títulos, listas longas) não vira formatação do WhatsApp; escreva a instrução do aplicativo pedindo respostas curtas e em texto simples.
Dica de instrução no Dify: "Responda em português, em no máximo 3 frases, sem markdown, e diga 'vou chamar um atendente' quando não souber."
E se o app for do tipo Agente?
O Dify informa que aplicativos do tipo Agente aceitam apenas streaming; no modo bloqueante, eles respondem com erro 400. Nesse caso a ProxyBox mostra no estado do bot: "O bot recusou a mensagem; confira a configuração". A recomendação é usar Chatbot ou Chatflow. Se você precisa de um agente com ferramentas, publique-o como Chatflow, ou use o tipo n8n/webhook e chame o agente do seu lado.
Quais erros aparecem com o Dify?
| Sintoma | Causa provável |
|---|---|
Estado error: "O bot recusou a mensagem" |
Chave errada, app do tipo Agente ou app não publicado |
| Resposta vazia | O app devolveu answer em branco; revise o prompt |
| A conversa "esquece" | O Dify apagou o conversation_id (retenção); o recomeço é automático |
| "Endereço não permitido" | O seu Dify está em rede interna ou em http |
O que está não confirmado no Dify?
- O comportamento de apps do tipo Agente em modo bloqueante segue a página oficial do Dify; não foi testado contra um app real.
- Entradas (
inputs) personalizadas do aplicativo não são enviadas: a ProxyBox mandainputsvazio. Se o seu app exige variáveis obrigatórias, defina valores padrão no próprio Dify. - O tempo de resposta do Dify conta: o limite da chamada é de 15 segundos (conexão de 5). Respostas mais lentas viram erro.
Como ligo um fluxo do Flowise?
O que preciso para o Flowise?
- O Flowise rodando em https público (na sua máquina virtual ou numa hospedagem).
- O id do fluxo (
chatflow id), que aparece no endereço do fluxo e na janela de incorporação. - Uma chave de API do Flowise, se você protegeu o fluxo.
- Uma instância conectada e a chave da ProxyBox.
Como configuro o Flowise?
curl -X PUT "https://proxybox.com.br/api/whatsapp/v1/integrations/bot" \
-H "apikey: SUA_CHAVE" -H "Content-Type: application/json" \
-d '{
"type": "flowise",
"enabled": true,
"url": "https://flowise.suaempresa.com.br",
"bot_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"api_key": "CHAVE_DO_FLOWISE",
"trigger": "all",
"ignore_groups": true,
"delay_seconds": 2
}'
A api_key é opcional e vai como Authorization: Bearer. Se o seu Flowise usa outro cabeçalho, defina api_key_header com o nome dele.
O que a ProxyBox envia?
{
"question": "Vocês têm o modelo X em estoque?",
"overrideConfig": { "sessionId": "5547999999999" },
"chatId": "5547999999999"
}
questioné o texto da pessoa;overrideConfig.sessionIdidentifica o contato, para a memória do fluxo separar as conversas;chatIdé enviado também, por segurança (veja não confirmado abaixo);- a resposta usada é o campo
text.
Como deve ser o fluxo?
Para o WhatsApp, vale desenhar o fluxo assim:
- Memória por sessão ligada (para lembrar o que foi dito antes);
- Instrução curta no modelo: respostas objetivas, sem markdown, em português;
- Fonte de conhecimento (documentos ou FAQ) para responder com base no que a empresa diz;
- Saída em texto: a ProxyBox lê
text. Se o fluxo devolver outros campos, eles são ignorados.
Como é a resposta do Flowise no WhatsApp?
O text vira mensagem(ns) de até 1.500 caracteres, com pausa de 1 segundo entre elas e até 10 por turno. Imagens, arquivos e fontes citadas pelo Flowise não são enviados: só o texto.
Quais limites valem?
- 15 segundos para o Flowise responder (conexão de 5). Fluxos que consultam muitas fontes podem estourar; simplifique ou use o tipo n8n/webhook com uma resposta rápida e uma segunda mensagem.
- 1 MB de resposta.
- 20 respostas por hora em cada conversa e 200 por dia na instância.
- Sem memória própria da ProxyBox: este tipo não usa
history_messages, quem lembra é o Flowise.
Quais erros aparecem com o Flowise?
| Sintoma | Causa provável |
|---|---|
Estado error |
Id do fluxo errado, chave errada ou Flowise indisponível |
| Resposta vazia | O fluxo não devolveu text |
| Responde sem lembrar | A memória do fluxo não está ligada ou não usa o sessionId |
| "Endereço não permitido" | Flowise em rede interna, em http ou com porta fora do padrão |
Depois de 10 falhas seguidas o bot é desligado automaticamente, e a ProxyBox avisa. Salvar a configuração de novo reativa.
O que está não confirmado no Flowise?
- O campo
chatIdno corpo não aparece na página de documentação consultada (sóoverrideConfig.sessionId); por isso enviamos os dois e o Flowise ignora o que não usa. - O formato da resposta pode variar entre versões do Flowise; o adaptador lê
texte trata a ausência como erro tratado. - Streaming, upload de arquivos e histórico enviado pelo corpo não são usados.
Qual dos dois escolho, e quando usar outro tipo?
Use o Dify para atendimento por base de conhecimento (a resposta sai do que você cadastrou) e o Flowise para agentes com etapas. Se o seu fluxo já existe no n8n, o tipo n8n ou webhook chama o seu servidor sem depender de plataforma. Em qualquer caso valem os limites do bot: 20 respostas por hora em cada conversa, 200 por dia, 15 segundos de espera e a pausa quando você responde pelo celular. Para uma pessoa ler antes de a resposta sair, ligue a aprovação humana.
Veja também
- Bots de WhatsApp pela API: tipos e limites
- Bot de IA no WhatsApp com OpenAI, Groq, Ollama
- Bot de WhatsApp por n8n ou webhook próprio
- Aprovação humana de mensagens da API de WhatsApp
Índice completo: índice dos guias. Sobre o produto: API de WhatsApp para o seu sistema.
Autoria: equipe técnica da ProxyBox. Atualizado em 11/11/2026. Fontes do formato: documentação pública do Dify (send-chat-message) e do Flowise (prediction), lidas em 11/11/2026. Recurso em beta.