Empresa brasileira · Entrega automática · Suporte em português Seg a sex, 9h as 18h · PIX em reais
ProxyBox
API de WhatsApp · Bots e IA

Dify e Flowise no WhatsApp: ligar um app ou fluxo à sua instância

Ligue um app do Dify ou um fluxo do Flowise à instância de WhatsApp: chave, endereço, memória por contato, limites e pontos não confirmados.

8 min de leitura Atualizado em 14 de novembro de 2026
Resposta curta
No PUT /integrations/bot, use type: "dify" (com a api_key do aplicativo) ou type: "flowise" (com o url do seu servidor e o bot_id, o id do fluxo). A ProxyBox chama o Dify em chat-messages, em modo bloqueante, ou o Flowise em prediction, guarda a memória por contato (conversation_id ou sessionId) e envia o texto devolvido pelo seu número.

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?

  1. Um aplicativo do tipo Chatbot ou Chatflow publicado no Dify.
  2. A chave de API do aplicativo (cada app tem a sua), na área de acesso à API.
  3. Uma instância conectada e a chave.

Como configuro o Dify?

bash
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:

json
{
  "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);
  • user identifica o contato (o telefone), o que permite ao Dify agrupar histórico e métricas por pessoa;
  • conversation_id só 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 manda inputs vazio. 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?

  1. O Flowise rodando em https público (na sua máquina virtual ou numa hospedagem).
  2. O id do fluxo (chatflow id), que aparece no endereço do fluxo e na janela de incorporação.
  3. Uma chave de API do Flowise, se você protegeu o fluxo.
  4. Uma instância conectada e a chave da ProxyBox.

Como configuro o Flowise?

bash
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?

json
{
  "question": "Vocês têm o modelo X em estoque?",
  "overrideConfig": { "sessionId": "5547999999999" },
  "chatId": "5547999999999"
}
  • question é o texto da pessoa;
  • overrideConfig.sessionId identifica 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:

  1. Memória por sessão ligada (para lembrar o que foi dito antes);
  2. Instrução curta no modelo: respostas objetivas, sem markdown, em português;
  3. Fonte de conhecimento (documentos ou FAQ) para responder com base no que a empresa diz;
  4. 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 chatId no 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ê text e 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

Í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.

Perguntas frequentes

O Dify funciona com aplicativos do tipo Agente?
Não é o caso recomendado. O Dify informa que apps do tipo Agente aceitam só streaming, e a ProxyBox usa o modo bloqueante. Prefira Chatbot ou Chatflow.
Como o Flowise lembra de cada contato?
A ProxyBox envia um sessionId por contato em overrideConfig, e o fluxo usa a memória que você configurou.
O endereço do Dify ou do Flowise precisa ser público?
Precisa ser https e alcançável da internet. Endereços internos ou em http são recusados pela guarda de rede.

Guias relacionados

Pronto para colocar no ar?

Comece no sandbox, grátis. Quando funcionar, contrate a instância do seu número e pague com PIX ou saldo.

Com IP brasileiro dedicado R$ 89,90/mês
Só a instância (traga o seu IP) R$ 39,90/mês
Travou em alguma etapa?Manda o print do erro no WhatsApp. Respondemos em português.
Suporte em português Fale no WhatsApp