← Voltar ao Blog
começando tutorial whatsapp agentes-ia

Começando com o Pipes.bot: Conecte Seu Agente de IA ao WhatsApp em 5 Minutos

Equipe Pipes.bot -
Read in English →

Por que Pipes.bot?

Se você já tentou conectar um agente de IA ao WhatsApp, provavelmente encontrou o dilema do Baileys: bibliotecas não oficiais que arriscam banir seu número de telefone, exigem portas expostas e derrubam sessões sem aviso.

O Pipes.bot resolve isso fornecendo uma ponte gerenciada para a API Cloud oficial do WhatsApp da Meta. Seu agente conecta de saída ao nosso serviço — sem portas abertas, sem engenharia reversa, sem violações de política.

Pré-requisitos

Antes de começar, certifique-se de ter:

  • Uma conta no Pipes.bot (cadastre-se aqui)
  • Um agente de IA auto-hospedado (OpenClaw, LangChain, customizado, etc.) ou um endpoint webhook (n8n, Make, Zapier)
  • Seu número pessoal do WhatsApp para ativação

Passo 1: Escolha Seu Modo de Entrega

O Pipes.bot suporta duas formas de receber mensagens:

  • Modo WebSocket — Instale o plugin OpenClaw para comunicação bidirecional em tempo real com seu agente de IA.
  • Modo Webhook — Aponte para qualquer endpoint HTTP e enviaremos mensagens via POST. Perfeito para n8n, Make, Zapier ou APIs customizadas.

Passo 2: Obtenha Sua Chave API

Acesse seu painel do Pipes.bot e gere uma chave API. Guarde-a com segurança — ela é exibida apenas uma vez.

Passo 3: Ative um Número

No painel, gere um código de ativação e envie via WhatsApp para um dos nossos números pool. Isso vincula seu número pessoal ao número pool para roteamento de mensagens.

Passo 4: Conecte Seu Agente

Para modo WebSocket:

openclaw plugins install @pipes.bot/pipes-bot-channel

Configure o plugin com sua chave API e pronto.

Para modo Webhook:

Defina sua URL de webhook no painel. Começaremos a enviar mensagens via POST para seu endpoint imediatamente.

Passo 5: Comece a Conversar

Envie uma mensagem para seu número pool pelo WhatsApp. Seu agente recebe, processa e responde — tudo através da API oficial da Meta.

E as Mensagens Offline?

Se seu agente cair, o Pipes.bot enfileira até 100 mensagens e as entrega quando você reconectar. Você ainda recebe uma notificação no WhatsApp para saber que seu agente está offline.

Próximos Passos

  • Explore o BYON (Traga Seu Próprio Número) nos planos Pro para usar seu próprio número WhatsApp Business
  • Confira a documentação para referência da API e configuração avançada
  • Junte-se à comunidade para dicas e suporte