# Pipes Bot - Complete Documentation

This file contains all documentation concatenated into a single file for easy consumption by LLMs.

> AI-powered WhatsApp chatbot platform for businesses. Build, deploy and manage intelligent conversational bots with ease.

## Table of Contents

This document includes all content from this project.
Each section is separated by a horizontal rule (---) for easy parsing.

---

# About Pipes.bot - The Team Behind the WhatsApp API Bridge

URL: https://www.pipes.bot/about

> Pipes.bot is the managed WhatsApp Cloud API bridge for AI agents. Built by ID49 Digital LLC to make WhatsApp integration safe and simple.

## About Pipes.bot

The safe way to connect AI agents to WhatsApp

## Why We Built Pipes.bot

Developers building AI agents face a frustrating choice when it comes to WhatsApp: use unofficial libraries like Baileys that risk permanent account bans, or navigate Meta's complex tech provider onboarding process that can take weeks. Neither option is acceptable when you just want your agent to send and receive messages reliably.

Pipes.bot was created to eliminate that tradeoff. We provide a managed bridge to Meta's official WhatsApp Cloud API that any developer can set up in minutes — no reverse engineering, no exposed ports, and no risk of losing your phone number.

## What We Do

Pipes.bot sits between your self-hosted AI agent and WhatsApp's official Cloud API. Your agent connects outbound to our service via WebSocket or webhook — meaning your server stays completely private behind your firewall. We handle message routing, offline queuing, media support, and webhook security so you can focus on building your agent, not managing infrastructure.

Whether you use Pool Numbers for quick personal setups or Bring Your Own Number (BYON) for business-grade messaging, every message flows through Meta's official API. No exceptions.

## Who We Are

TF

### Tulio Faria

Founder & Developer

Tulio is a software engineer with over 15 years of experience building developer tools, APIs, and real-time systems. After watching developers lose their WhatsApp accounts to unofficial automation libraries, he built Pipes.bot to give the AI agent community a safe, compliant path to WhatsApp — without the complexity of becoming a Meta tech provider. He personally responds to every inquiry at [hi@pipes.bot](mailto:hi@pipes.bot).

## The Company

Pipes.bot is operated by **ID49 Digital LLC**, a company focused on building developer infrastructure for messaging and AI. We are registered as a tech provider with Meta, which means our users skip the entire WhatsApp Business API onboarding process. Our infrastructure runs on CockroachDB and AWS, with real-time WebSocket connections managed on our own servers.

## What We Believe

### Privacy First

We never store message content. Messages in transit are not persisted, and offline queues are deleted upon delivery. Your conversations are yours.

### No Shortcuts

Every message flows through Meta's official API. We don't use reverse-engineered protocols, and we never will. Compliance is not optional.

### Developer Experience

Setup should take minutes, not weeks. We handle the infrastructure complexity so developers can focus on building great AI agents.

### Transparency

Simple pricing, clear terms, and honest communication. We publish our [privacy policy](/privacy-policy) and [terms of service](/terms-of-service) in plain language.

## Get in Touch

Have questions, feedback, or want to discuss a use case? Reach us at [hi@pipes.bot](mailto:hi@pipes.bot) or visit our [contact page](/contact). For technical documentation, head to [docs.pipes.bot](https://docs.pipes.bot).

---

# Getting Started: AI Agent on WhatsApp

URL: https://www.pipes.bot/blog/getting-started-with-pipes-bot

> Learn how to connect your self-hosted AI agent to WhatsApp using Pipes.bot

[← Back to Blog](/blog)

getting-started tutorial whatsapp ai-agents

## Getting Started: AI Agent on WhatsApp

Pipes.bot Team - February 25, 2026

[Ler em Portugues →](/pt-br/blog/comecando-com-pipes-bot)

## Why Pipes.bot?

If you’ve ever tried to connect an AI agent to WhatsApp, you’ve probably run into the Baileys dilemma: unofficial libraries that risk getting your phone number banned, require exposed ports, and drop sessions without warning.

Pipes.bot solves this by providing a managed bridge to Meta’s **official WhatsApp Cloud API**. Your agent connects outbound to our service — no open ports, no reverse engineering, no policy violations.

## Prerequisites

Before you begin, make sure you have:

- A Pipes.bot account ([sign up here](https://app.pipes.bot))

- A self-hosted AI agent (OpenClaw, LangChain, custom, etc.) **or** a webhook endpoint (n8n, Make, Zapier)

- Your personal WhatsApp number for activation

## Step 1: Choose Your Delivery Mode

Pipes.bot supports two ways to receive messages:

- **WebSocket Mode** — Install the OpenClaw plugin for real-time, bidirectional communication with your AI agent.

- **Webhook Mode** — Point us at any HTTP endpoint and we’ll POST messages to it. Perfect for n8n, Make, Zapier, or custom APIs.

## Step 2: Get Your API Key

Head to your [Pipes.bot dashboard](https://app.pipes.bot) and generate an API key. Keep it safe — it’s shown only once.

## Step 3: Activate a Number

In the dashboard, generate an activation code and send it via WhatsApp to one of our pool numbers. This links your personal number to the pool number for message routing.

## Step 4: Connect Your Agent

**For WebSocket mode:**

openclaw plugins install @pipes.bot/pipes-bot-channel
Configure the plugin with your API key, and you’re live.

**For Webhook mode:**

Set your webhook URL in the dashboard. We’ll start POSTing messages to your endpoint immediately.

## Step 5: Start Chatting

Send a message to your pool number from WhatsApp. Your agent receives it, processes it, and replies — all through Meta’s official API.

## What About Offline Messages?

If your agent goes down, Pipes.bot queues up to 100 messages and delivers them when you reconnect. You’ll even get a WhatsApp notification so you know your agent is offline.

## Next Steps

- Explore **BYON (Bring Your Own Number)** on Pro plans to use your own WhatsApp Business number

- Check out the [docs](https://docs.pipes.bot) for API reference and advanced configuration

- Join the community for tips and support

---

# Pipes.bot Blog - WhatsApp AI Agent Tutorials & Updates

URL: https://www.pipes.bot/blog

> Explore tutorials, updates, and insights about connecting AI agents to WhatsApp using Meta

## Blog

Tutorials, updates, and insights

Learn how to connect AI agents to WhatsApp using Meta's official Cloud API. We cover everything from first-time setup to advanced automation patterns.

Expect step-by-step tutorials, product updates, developer guides, and best practices for building reliable WhatsApp integrations. Whether you're wiring up a custom GPT, connecting n8n workflows, or deploying a full support bot — you'll find practical advice here.

New to Pipes.bot? Start with our getting-started guides. Already building? Dive into webhook configuration, plugin development with OpenClaw, and message queuing strategies.

## Common Questions

### What topics does the Pipes.bot blog cover?

We publish tutorials on WhatsApp Cloud API integration, webhook setup, AI agent configuration, and automation workflows using tools like n8n and custom GPTs.

### How often do you publish new content?

We aim to publish new guides and updates regularly as the platform evolves. Subscribe or check back to stay up to date with the latest posts.

### Can I request a tutorial on a specific topic?

Yes. Send your suggestion to [hi@pipes.bot](mailto:hi@pipes.bot) and we will consider it for an upcoming post.

[whatsapp openclaw official-api ai-agents tutorial WhatsApp API OpenClaw: Official API Setup Integrate WhatsApp Official](/blog/whatsapp-api-openclaw)

[getting-started tutorial whatsapp ai-agents Getting Started: AI Agent on WhatsApp Learn how to connect your self-hosted](/blog/getting-started-with-pipes-bot)

---

# WhatsApp API OpenClaw: Official API Setup

URL: https://www.pipes.bot/blog/whatsapp-api-openclaw

> Integrate WhatsApp Official API with OpenClaw using Pipes.bot. No Baileys risks, no exposed ports — a secure bridge for your AI agent.

[← Back to Blog](/blog)

whatsapp openclaw official-api ai-agents tutorial

## WhatsApp API OpenClaw: Official API Setup

Tulio Faria - February 26, 2026

[Ler em Portugues →](/pt-br/blog/whatsapp-api-openclaw-pt)

## How to Use WhatsApp Official API with OpenClaw

If you run an OpenClaw installation and want to connect it to WhatsApp without risking your account, this guide is for you. The default OpenClaw WhatsApp channel relies on Baileys — an unofficial library that reverse-engineers the WhatsApp Web protocol. While it works, it violates Meta’s Terms of Service and can lead to permanent bans.

There is a better path. By using the **WhatsApp Official API with OpenClaw** through a bridge service like [Pipes.bot](https://www.pipes.bot/), you get a fully compliant, reliable connection that requires no open ports and no unofficial libraries. This article walks you through how it works, why it matters, and how to set it up.

**Key Takeaways:**

- OpenClaw’s default WhatsApp channel uses Baileys, which carries real ban risks

- Pipes.bot bridges the WhatsApp Official Cloud API to your OpenClaw installation via WebSocket

- The connection is outbound-only — your server stays private behind your firewall

- You get two-way messaging, media support, and webhook signature validation out of the box

- Setup takes roughly 5 minutes with no Meta tech provider onboarding required

---

## Table of Contents

- [Why the Default OpenClaw WhatsApp Setup Is Risky](#why-the-default-openclaw-whatsapp-setup-is-risky)

- [What Is Pipes.bot and How Does It Solve This](#what-is-pipesbot-and-how-does-it-solve-this)

- [Pool Numbers vs Bring Your Own Number](#pool-numbers-vs-bring-your-own-number)

- [How the WhatsApp API OpenClaw Integration Works](#how-the-whatsapp-api-openclaw-integration-works)

- [Step-by-Step Setup Guide](#step-by-step-setup-guide)

- [Practical Use Cases](#practical-use-cases)

- [Comparing Baileys vs Official API for OpenClaw](#comparing-baileys-vs-official-api-for-openclaw)

- [Frequently Asked Questions](#frequently-asked-questions)

---

## Why the Default OpenClaw WhatsApp Setup Is Risky

OpenClaw connects to WhatsApp through the [Baileys library](https://github.com/WhiskeySockets/Baileys) — a TypeScript implementation that reverse-engineers the WhatsApp Web multi-device protocol. When you scan the QR code during OpenClaw setup, Baileys emulates a linked device on your personal WhatsApp account.

This approach has three concrete problems.

**Account bans are increasing.** Meta actively detects accounts using unofficial automation. In a [GitHub issue on the Baileys repository](https://github.com/WhiskeySockets/Baileys/issues/1869), multiple developers reported bans on accounts that had been running bots for over 3 years without issues — until they suddenly were banned permanently. The detection is getting stricter, not looser.

**Protocol breakage is unpredictable.** Baileys depends on reverse-engineering a protocol that Meta can change at any time. When WhatsApp updates their servers, Baileys connections can enter reconnect loops. Those abnormal connection patterns are exactly what ban detection systems flag.

**Meta’s 2026 policy tightened the rules.** As of January 2026, Meta explicitly blocks general-purpose chatbots on WhatsApp. While business-operation chatbots (customer support, order tracking, FAQs) remain allowed under the Business API, the enforcement net has widened. Using an unofficial library puts your account in a gray area that is increasingly becoming a red zone.

If your OpenClaw agent handles anything important — scheduling, business queries, automation triggers — losing your WhatsApp account means losing that entire workflow overnight.

---

## What Is Pipes.bot and How Does It Solve This

[Pipes.bot](https://www.pipes.bot/) is a managed bridge between WhatsApp’s official Cloud API and self-hosted AI agents like OpenClaw. It was created by Tulio Faria specifically to solve the problem described above: giving developers a safe, compliant way to connect WhatsApp to their agents without reverse engineering.

Here is what Pipes.bot does differently:

- **Uses Meta’s official WhatsApp Cloud API** — no reverse engineering, no policy violations

- **Connects via outbound WebSocket** — your OpenClaw installation makes an outbound connection to Pipes.bot, meaning you never expose ports or your server’s IP address

- **Queues messages** — if your agent goes offline, Pipes.bot queues up to 100 messages and delivers them when it reconnects

- **Supports all media types** — text, images, documents, audio, video — everything the official API supports

- **Validates webhooks with HMAC signatures** — a hash secret ensures no man-in-the-middle tampering with incoming messages

The key architectural difference is that your OpenClaw gateway stays completely private behind your firewall. The WebSocket connection is initiated from your side, so there is nothing to expose publicly.

---

## Pool Numbers vs Bring Your Own Number

Pipes.bot offers two modes for connecting WhatsApp to OpenClaw. The right choice depends on whether you want to use a dedicated number for your agent or your own business number.

### Pool Numbers

With Pool Numbers, Pipes.bot provides phone numbers that you activate and link to your personal WhatsApp. The flow is simple: you save a Pipes.bot pool number as a contact, send it a message to activate the pairing, and from that point on, every message you send to that number gets forwarded to your OpenClaw agent via webhook or WebSocket.

**When to use Pool Numbers:**

- You want to connect your personal AI agent without buying a new number

- You need multiple numbers for different agents or automations (e.g., one number for scheduling, another for note-taking)

- You want to test the integration before committing to a business number

- You need separate entry points for different n8n or Make workflows

Each plan on Pipes.bot includes a set number of pool number activations. If you have 3 pool numbers, you can route messages to 3 different agents, automations, or OpenClaw installations — each with its own webhook or WebSocket endpoint.

### Bring Your Own Number (BYON)

With BYON, you onboard your own phone number (or your customers’ numbers) onto the Pipes.bot platform. The number goes through Meta’s official embedded signup flow — the same Facebook domain-based process that any WhatsApp Business API provider uses. This means full compliance with WhatsApp’s terms of service.

**When to use BYON:**

- You have a dedicated business number for customer communication

- You are building a SaaS product that sends WhatsApp messages on behalf of your users

- You need your customers to onboard their own numbers through a branded flow

- You want to send order confirmations, appointment reminders, or campaign messages from a recognized business number

The BYON mode also supports white-label onboarding. You can customize the onboarding screen with your own brand, logo, and a custom message so your end users recognize the flow as coming from your application — not from Pipes.bot directly.

After a number is onboarded, Pipes.bot sends a webhook notification containing the event type and the number ID. From that point, you use the number ID to send and receive messages through the API.

---

## How the WhatsApp API OpenClaw Integration Works

The architecture is straightforward. Here is the data flow when a message arrives:

- A user sends a WhatsApp message to your Pipes.bot number (pool or BYON)

- WhatsApp’s official Cloud API receives the message and forwards it to Pipes.bot

- Pipes.bot validates the message and forwards it to your configured endpoint — either a webhook URL or an active WebSocket connection

- Your OpenClaw installation receives the message over the WebSocket, processes it through your configured LLM (OpenAI, Anthropic, Google, etc.), and generates a response

- OpenClaw sends the reply back through Pip

---

# Contact Pipes.bot - Get Help with WhatsApp AI Integration

URL: https://www.pipes.bot/contact

> Get in touch with the Pipes.bot team for inquiries, technical support, or partnerships. We help you connect AI agents to WhatsApp.

## Contact Us

We'd love to hear from you

Whether you need help with your WhatsApp integration, want to explore a partnership, or have a question about the platform, we are here to help. Choose the best channel below or check our FAQ for quick answers.

## General Inquiries

Questions, feedback, or partnership opportunities

[hi@pipes.bot](mailto:hi@pipes.bot)

## Support & Docs

Technical help, API reference, and setup guides

[docs.pipes.bot](https://docs.pipes.bot)

## Get Started

Create your account and connect your agent in minutes

[app.pipes.bot](https://app.pipes.bot)

## Frequently Asked Questions

### How fast do you respond to emails?

We typically reply within 24 hours on business days. For urgent issues, include "URGENT" in the subject line.

### Do you offer technical support?

Yes. Check [docs.pipes.bot](https://docs.pipes.bot) first for self-service guides. If you're stuck, email us and we'll help you debug.

### Is there a community or Discord server?

Not yet, but it's on our roadmap. For now, reach out via email and follow our blog for updates.

### How do I report a bug?

Send an email to [hi@pipes.bot](mailto:hi@pipes.bot) with steps to reproduce, your pipe ID, and any error messages. We take bugs seriously.

### Are you open to partnerships or integrations?

Absolutely. Whether you're building an AI platform, an automation tool, or a SaaS product — we'd love to talk. Email us with details about what you have in mind.

### What is the response time for technical issues?

For technical issues affecting production traffic, we prioritize responses and typically follow up within a few hours during business days. Include your pipe ID and any relevant error logs to help us resolve the issue faster.

**ID49 Digital LLC** — Pipes.bot

---

# Pipes.bot - The Safe WhatsApp Bridge for AI Agents

URL: https://www.pipes.bot

> Connect your self-hosted AI agent to WhatsApp in 5 minutes using Meta

Built on Meta's Official WhatsApp Cloud API

## Talk to Your AI Agent on WhatsApp—Without Getting Banned

Connect your AI agent, automation, or app to WhatsApp in 5 minutes. No Baileys. No exposed ports. No account risk.

[Get Started →](https://app.pipes.bot) ▶
See how it works (2 min)

Pipes.bot Dashboard

Status

Online

Last Sync

Just now

$ Terminal

> openclaw plugins install @pipes.bot/pipes-bot-channel
Plugin installed successfully

> pipes-bot --configure [KEY_HIDDEN]

WhatsApp Preview Active

Hey, what's my schedule today?

You have 3 meetings today. Starting at 10 AM with the marketing team.

## Running Your Agent on WhatsApp Shouldn't Feel Like Defusing a Bomb

The Baileys Reality:

### Account bans

WhatsApp detects unofficial clients and blocks your number

### Session drops

QR codes expire, messages vanish into the void

### Network headaches

Cloudflare Tunnel? Tailscale? ngrok? Just to receive a message?

### Phone number at stake

One wrong move and you lose it forever

"You built your AI agent to make life easier. Getting it on WhatsApp shouldn't be the hard part."

## One Connection. Full WhatsApp Access.

Pipes.bot is a managed bridge between WhatsApp's official Cloud API and your self-hosted AI agent or application.

How it works

Your Agent

connects outbound →

Pipes.bot

→

WhatsApp Cloud API

01

### Stays Private

Your agent is never exposed to the public internet.

02

### Stays Safe

No reverse engineering means no Meta bans.

03

### Just Works

Reliable message delivery even through NATs.

[Get Started →](https://app.pipes.bot)

## Why Pipes.bot?

### Official API, Zero Risk

We use Meta's WhatsApp Cloud API—the same infrastructure businesses trust. No reverse engineering. No policy violations. No surprises.

### Your Agent Stays Private

Traditional setups require exposing your gateway to the internet. With Pipes.bot, your plugin connects outbound. Works through NAT, firewalls, anything.

### Messages Never Get Lost

Agent offline? We queue up to 100 messages and deliver them when you reconnect. You'll even get a WhatsApp notification when your agent goes down.

### Webhooks & Automation Ready

Connect n8n, Make, Zapier, or any HTTP endpoint. Pipes.bot POSTs messages to your URL, and you reply via our REST API. No plugin needed.

## Live in 5 Minutes

1

### Sign up

Create your Pipes.bot account

2

### Choose your mode

Install the OpenClaw plugin for AI agents, set a webhook URL for automations, or create a BYON App for custom products

3

### Add your API key

Paste your unique key in the config

4

### Activate your number

Send a code to a pool number via WhatsApp — or onboard your own via BYON

5

### Start chatting

Your agent or app is now live on WhatsApp

[Get Started →](https://app.pipes.bot)

## Trusted by OpenClaw Users

"
"I was terrified of losing my phone number to a Baileys ban. Pipes.bot solved that in one afternoon."

MR

Marcus R.

Personal Productivity Enthusiast

"
"Finally got my home AI on WhatsApp without opening a single port. The queue feature saved me when my Pi went offline."

ST

Sofia T.

Self-hosted AI enthusiast

### Early Access Stats

99.9%

Message delivery rate

<500ms

Median latency

0

Account bans

## Simple, Transparent Pricing

### Starter

$5 /mo

- 1 Pool number
- Unlimited messages
- Offline queue
- Community support
[Get Started →](https://app.pipes.bot)

Most Popular

### Pro

$9 /mo

- 3 Pool numbers
- Unlimited messages
- BYON available
- Offline queue
- Email support
[Get Started →](https://app.pipes.bot)

### Pro+

$19 /mo

- 5 Pool numbers
- Unlimited messages
- BYON available
- Offline queue
- Priority support
[Get Started →](https://app.pipes.bot)

BYON add-on: +$5/number/month on Pro and Pro+ plans

## Common Questions

Will my WhatsApp number get banned? +
No. We use Meta's official Cloud API—the same infrastructure used by businesses worldwide. There's no reverse engineering or policy violations involved.

Do I need to expose my agent to the internet? +
No. Our plugin makes an outbound connection from your network. Your gateway stays completely private behind your firewall.

What happens if my agent goes offline? +
We queue your messages (up to 100) and deliver them when your agent reconnects. You'll also get a WhatsApp notification so you know what's happening.

Can I use my own business WhatsApp number? +
Yes, on Pro and Pro+ plans. We support "Bring Your Own Number" (BYON) through Meta's Embedded Signup flow at +$5/number/month.

Does this work with n8n, Make, or Zapier? +
Absolutely. Use webhook mode — we POST messages directly to your URL, and you reply via our REST API. No plugin needed, works with any HTTP endpoint.

---

# Privacy Policy - Pipes.bot WhatsApp API Proxy

URL: https://www.pipes.bot/privacy-policy

> Privacy Policy for Pipes.bot, the managed WhatsApp Cloud API proxy for AI agents. Learn how we collect, use, and protect your data.

## Privacy Policy

Pipes.bot — WhatsApp Cloud API Proxy for AI Agents

**Effective Date:** February 2, 2026

**Last Updated:** February 2, 2026

## 1. Introduction

Pipes.bot is operated by **ID49 Digital LLC** ("we," "us," or "our"). We provide a managed WhatsApp Cloud API proxy service that connects self-hosted AI agents to WhatsApp through Meta's official Business API. This Privacy Policy explains how we collect, use, store, and protect your information when you use our platform, including our website, dashboard, APIs, and Clawdbot plugin (collectively, the "Service").

By creating an account or using the Service, you agree to the practices described in this policy. If you do not agree, please do not use the Service.

## 2. Information We Collect

### 2.1 Account Information

When you register for Pipes.bot, we collect:

- **Email address** — used for authentication, account recovery, and service communications.
- **Personal phone number** (in E.164 format) — used to route WhatsApp messages between you and your AI agent. This number is stored as your fromNumber and linked to your tenant account.

### 2.2 Service Configuration Data

As you set up and use the Service, we store:

- **API keys** — hashed and stored securely. We retain only a short prefix (e.g., pk_live_abc...) for display purposes. The full key is never stored in plaintext.
- **Pool number activations** — records linking your phone number to specific pool numbers, including optional labels you assign (e.g., "work," "personal").
- **Webhook configuration** — if you use Webhook delivery mode, we store your webhook URL and a webhook secret you provide for signature verification.
- **Delivery mode preference** — whether you use WebSocket (Clawdbot plugin) or Webhook (n8n, Make, Zapier, etc.) delivery.
- **BYON connection details** (if applicable) — WhatsApp Business Account ID, phone number ID, OAuth access tokens (encrypted at rest), and your chosen response mode (OWNER_ONLY or ALL_NUMBERS).

### 2.3 Message Data

Pipes.bot processes WhatsApp messages as a relay between you and your AI agent. Our message handling is designed to minimize data retention:

- **Messages in transit** are not persisted to any database.
- **Messages queued while your agent is offline** are held temporarily on our servers for a maximum of 24 hours or until delivered, whichever comes first. Queued messages are deleted immediately upon delivery or upon expiration.
- **Message content is never logged.** Our application logs record metadata (e.g., message IDs, timestamps, delivery status) but never the text or media content of your messages.

### 2.4 Technical & Usage Data

We automatically collect limited technical information to operate and improve the Service:

- **Connection metadata** — timestamps of when your plugin connects or disconnects, connection duration, and online/offline status.
- **Message volume counts** — aggregate counts of messages sent and received per tenant, used for usage limits and analytics. These counts do not include message content.
- **Error and delivery logs** — records of failed message deliveries or webhook delivery attempts, including HTTP status codes and error types (but not message content).
- **Plugin version information** — the version of your Clawdbot plugin and Clawdbot gateway, sent during WebSocket authentication.

### 2.5 Information We Do NOT Collect

- We do not collect your name, physical address, payment card details (until billing is implemented), or any demographic information.
- We do not read, analyze, train on, or store the content of your WhatsApp messages beyond the temporary queuing described above.
- We do not use cookies for advertising or tracking. Our dashboard may use session cookies strictly for authentication.

## 3. How We Use Your Information

We use the information we collect for the following purposes:

Purpose

Data Used

**Provide the Service**

Email, phone number, API keys, activations, webhook config

**Route messages**

Phone number, pool number activations, BYON configuration

**Queue offline messages**

Message content (temporarily, in memory only)

**Authenticate you**

Email, session tokens, API key hashes

**Notify you of agent status**

Phone number (to send WhatsApp notifications when your agent goes offline/online)

**Monitor service health**

Connection metadata, error logs, message volume counts

**Enforce usage limits**

Message volume counts, plan tier

**Improve the Service**

Aggregated, anonymized usage metrics

**Communicate with you**

Email (service updates, security alerts)

We do **not** use your data for advertising, profiling, or selling to third parties.

## 4. How We Share Your Information

### 4.1 Meta Platforms (WhatsApp)

To deliver messages via WhatsApp, we interact with Meta's WhatsApp Cloud API. This means:

- Your phone number and message content are transmitted to Meta's servers as part of the standard WhatsApp message delivery flow.
- Pool numbers are registered under Pipes.bot's WhatsApp Business Account (WABA). BYON numbers are registered under your own WABA.
- Meta's use of this data is governed by [Meta's Privacy Policy](https://www.facebook.com/privacy/policy/) and the [WhatsApp Business Terms](https://www.whatsapp.com/legal/business-terms).

### 4.2 Infrastructure Providers

Our Service relies on the following infrastructure providers, which may process data on our behalf:

- **CockroachDB (Cockroach Labs)** — hosts our database. Governed by [Cockroach Labs' Privacy Policy](https://www.cockroachlabs.com/privacy/).
- **Amazon Web Services (AWS)** — provides object storage (S3). Governed by the [AWS Privacy Notice](https://aws.amazon.com/privacy/).

These providers act as data processors under our instructions and are contractually obligated to protect your data.

### 4.3 Your AI Agent

Messages received on your behalf are forwarded to your self-hosted Clawdbot instance (via WebSocket or webhook). Pipes.bot does not control how your AI agent processes or stores this data. You are responsible for the privacy practices of your own AI agent.

### 4.4 Legal Requirements

We may disclose your information if required to do so by law or in response to valid legal process, such as a court order or subpoena. We will attempt to notify you before disclosing your information unless prohibited by law.

### 4.5 No Sale of Data

We do not sell, rent, or trade your personal information to any third party for any purpose.

## 5. Data Storage & Security

### 5.1 Infrastructure

Component

Provider

Purpose

Database

CockroachDB Serverless

Account data, activations, API key hashes

Object storage

Amazon S3

File and media storage

Real-time connections

Pipes.bot servers

WebSocket management, temporary message queue

Data is stored across CockroachDB Serverless (which provides encryption at rest and in transit), Amazon S3 (with server-side encryption), and our own servers for real-time WebSocket connections.

### 5.2 Security Measures

- **API keys** are hashed before storage. The original key is shown once at creation and never stored or retrievable.
- **BYON OAuth tokens** are encrypted at rest using AES-256 encryption.
- **Webhook signatures** use HMAC-SHA256 to verify the integrity of messages delivered to your systems.
- **Meta webhook verification** uses the X-Hub-Signature-256 header to validate all inbound messages from WhatsApp.
- **WebSocket connections** are authenticated using API keys and secured with TLS (wss://).
- **Rate limiting** is applied to all API endpoints to prevent abuse.
- **Admin access** is restricted to authorized Pipes.bot team members and requires explicit isAdmin privileges.

### 5.3 Data Retention

Data Type

Retention Period

Account data (email, phone)

Until you delete your account

API key hashes

Until revoked by you or account deletion

Pool activations

Until deactivated by you or account deletion

Queued messages (offline)

Maximum 24 hours, deleted upon delivery or expiration

Me

---

# Sobre o Pipes.bot - O Time por Trás da Ponte WhatsApp API

URL: https://www.pipes.bot/pt-br/about

> Pipes.bot é a ponte gerenciada de API Cloud do WhatsApp para agentes de IA. Criado pela ID49 Digital para integração WhatsApp segura e simples.

## Sobre o Pipes.bot

A forma segura de conectar agentes de IA ao WhatsApp

## Por Que Criamos o Pipes.bot

Desenvolvedores construindo agentes de IA enfrentam uma escolha frustrante quando se trata de WhatsApp: usar bibliotecas não oficiais como o Baileys que arriscam banimento permanente da conta, ou navegar pelo complexo processo de cadastro de provedor técnico da Meta que pode levar semanas. Nenhuma opção é aceitável quando você só quer que seu agente envie e receba mensagens de forma confiável.

O Pipes.bot foi criado para eliminar esse dilema. Fornecemos uma ponte gerenciada para a API Cloud oficial do WhatsApp da Meta que qualquer desenvolvedor pode configurar em minutos — sem engenharia reversa, sem portas expostas e sem risco de perder seu número de telefone.

## O Que Fazemos

O Pipes.bot fica entre seu agente de IA auto-hospedado e a API Cloud oficial do WhatsApp. Seu agente conecta de saída ao nosso serviço via WebSocket ou webhook — o que significa que seu servidor permanece completamente privado atrás do seu firewall. Cuidamos do roteamento de mensagens, enfileiramento offline, suporte a mídia e segurança de webhook para que você possa focar em construir seu agente, não em gerenciar infraestrutura.

Seja usando Números Pool para configurações pessoais rápidas ou Traga Seu Próprio Número (BYON) para mensagens de nível empresarial, toda mensagem flui pela API oficial da Meta. Sem exceções.

## Quem Somos

TF

### Tulio Faria

Fundador & Desenvolvedor

Tulio é um engenheiro de software com mais de 15 anos de experiência construindo ferramentas para desenvolvedores, APIs e sistemas em tempo real. Depois de ver desenvolvedores perderem suas contas do WhatsApp por causa de bibliotecas de automação não oficiais, ele criou o Pipes.bot para dar à comunidade de agentes de IA um caminho seguro e compatível para o WhatsApp — sem a complexidade de se tornar um provedor técnico da Meta. Ele responde pessoalmente a todas as mensagens em [hi@pipes.bot](mailto:hi@pipes.bot).

## A Empresa

O Pipes.bot é operado pela **ID49 Digital LLC**, uma empresa focada em construir infraestrutura para desenvolvedores nas áreas de mensageria e IA. Somos registrados como provedor técnico junto à Meta, o que significa que nossos usuários pulam todo o processo de cadastro da API WhatsApp Business. Nossa infraestrutura roda em CockroachDB e AWS, com conexões WebSocket em tempo real gerenciadas em nossos próprios servidores.

## No Que Acreditamos

### Privacidade em Primeiro Lugar

Nunca armazenamos conteúdo de mensagens. Mensagens em trânsito não são persistidas, e filas offline são excluídas após a entrega. Suas conversas são suas.

### Sem Atalhos

Toda mensagem flui pela API oficial da Meta. Não usamos protocolos de engenharia reversa e nunca usaremos. Conformidade não é opcional.

### Experiência do Desenvolvedor

A configuração deve levar minutos, não semanas. Cuidamos da complexidade da infraestrutura para que desenvolvedores possam focar em construir ótimos agentes de IA.

### Transparência

Preços simples, termos claros e comunicação honesta. Publicamos nossa [política de privacidade](/pt-br/privacy-policy) e [termos de serviço](/pt-br/terms-of-service) em linguagem clara.

## Entre em Contato

Tem perguntas, feedback ou quer discutir um caso de uso? Fale conosco em [hi@pipes.bot](mailto:hi@pipes.bot) ou visite nossa [página de contato](/pt-br/contact). Para documentação técnica, acesse [docs.pipes.bot](https://docs.pipes.bot).

---

# Começando: Conecte Seu Agente de IA ao WhatsApp

URL: https://www.pipes.bot/pt-br/blog/comecando-com-pipes-bot

> Aprenda como conectar seu agente de IA auto-hospedado ao WhatsApp usando a ponte oficial da API Cloud do Pipes.bot. Sem Baileys, sem portas expostas, sem risco.

[&larr; Voltar ao Blog](/pt-br/blog)

começando tutorial whatsapp agentes-ia

## Começando: Conecte Seu Agente de IA ao WhatsApp

Equipe Pipes.bot - 25 de fevereiro de 2026

[Read in English &rarr;](/blog/getting-started-with-pipes-bot)

## 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](https://app.pipes.bot))

- 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](https://app.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](https://docs.pipes.bot) para referência da API e configuração avançada

- Junte-se à comunidade para dicas e suporte

---

# Blog Pipes.bot - Tutoriais sobre WhatsApp e Agentes de IA

URL: https://www.pipes.bot/pt-br/blog

> Tutoriais, novidades e insights sobre conectar agentes de IA ao WhatsApp usando a API Cloud oficial da Meta com o Pipes.bot.

## Blog

Tutoriais, novidades e insights

Aprenda a conectar agentes de IA ao WhatsApp usando a API Cloud oficial da Meta. Cobrimos desde a configuração inicial até padrões avançados de automação.

Aqui você encontra tutoriais passo a passo, novidades do produto, guias para desenvolvedores e boas práticas para criar integrações confiáveis com o WhatsApp. Seja para conectar um GPT personalizado, automatizar fluxos com n8n ou criar um bot de suporte completo — temos conteúdo prático para você.

Novo no Pipes.bot? Comece pelos nossos guias de introdução. Já está construindo? Explore configuração de webhooks, desenvolvimento de plugins com OpenClaw e estratégias de enfileiramento de mensagens.

## Perguntas Comuns

### Quais temas o blog do Pipes.bot aborda?

Publicamos tutoriais sobre integração com a API Cloud do WhatsApp, configuração de webhooks, agentes de IA e automações com ferramentas como n8n e GPTs personalizados.

### Posso sugerir um tema para tutorial?

Sim. Envie sua sugestão para [hi@pipes.bot](mailto:hi@pipes.bot) e avaliaremos para um post futuro.

[whatsapp openclaw api-oficial agentes-ia tutorial WhatsApp API OpenClaw: API Oficial Integre a API Oficial do WhatsApp c](/pt-br/blog/whatsapp-api-openclaw-pt)

[começando tutorial whatsapp agentes-ia Começando: Conecte Seu Agente de IA ao WhatsApp Aprenda como conectar seu agente](/pt-br/blog/comecando-com-pipes-bot)

---

# WhatsApp API OpenClaw: API Oficial

URL: https://www.pipes.bot/pt-br/blog/whatsapp-api-openclaw-pt

> Integre a API Oficial do WhatsApp com o OpenClaw usando o Pipes.bot. Sem Baileys, sem portas expostas — uma ponte segura para seu agente de IA.

[&larr; Voltar ao Blog](/pt-br/blog)

whatsapp openclaw api-oficial agentes-ia tutorial

## WhatsApp API OpenClaw: API Oficial

Tulio Faria - 26 de fevereiro de 2026

[Read in English &rarr;](/blog/whatsapp-api-openclaw)

## Como Usar a API Oficial do WhatsApp com o OpenClaw

Se você tem uma instalação do OpenClaw e quer conectá-la ao WhatsApp sem arriscar sua conta, este guia é para você. O canal padrão de WhatsApp do OpenClaw depende do Baileys — uma biblioteca não oficial que faz engenharia reversa do protocolo do WhatsApp Web. Embora funcione, viola os Termos de Serviço da Meta e pode levar a banimentos permanentes.

Existe um caminho melhor. Usando a **API Oficial do WhatsApp com o OpenClaw** através de um serviço de ponte como o [Pipes.bot](https://www.pipes.bot/), você obtém uma conexão totalmente compatível e confiável que não exige portas abertas nem bibliotecas não oficiais. Este artigo mostra como funciona, por que isso importa e como configurar.

**Principais Pontos:**

- O canal padrão de WhatsApp do OpenClaw usa Baileys, que traz riscos reais de banimento

- O Pipes.bot faz a ponte entre a API Cloud oficial do WhatsApp e sua instalação do OpenClaw via WebSocket

- A conexão é somente de saída — seu servidor permanece privado atrás do seu firewall

- Você obtém mensagens bidirecionais, suporte a mídia e validação de assinatura de webhook inclusos

- A configuração leva cerca de 5 minutos sem necessidade de cadastro como provedor técnico da Meta

---

## Índice

- [Por Que a Configuração Padrão de WhatsApp do OpenClaw É Arriscada](#por-que-a-configura%C3%A7%C3%A3o-padr%C3%A3o-de-whatsapp-do-openclaw-%C3%A9-arriscada)

- [O Que É o Pipes.bot e Como Ele Resolve Isso](#o-que-%C3%A9-o-pipesbot-e-como-ele-resolve-isso)

- [Números Pool vs Traga Seu Próprio Número](#n%C3%BAmeros-pool-vs-traga-seu-pr%C3%B3prio-n%C3%BAmero)

- [Como Funciona a Integração WhatsApp API OpenClaw](#como-funciona-a-integra%C3%A7%C3%A3o-whatsapp-api-openclaw)

- [Guia de Configuração Passo a Passo](#guia-de-configura%C3%A7%C3%A3o-passo-a-passo)

- [Casos de Uso Práticos](#casos-de-uso-pr%C3%A1ticos)

- [Comparando Baileys vs API Oficial para OpenClaw](#comparando-baileys-vs-api-oficial-para-openclaw)

- [Perguntas Frequentes](#perguntas-frequentes)

---

## Por Que a Configuração Padrão de WhatsApp do OpenClaw É Arriscada

O OpenClaw se conecta ao WhatsApp através da [biblioteca Baileys](https://github.com/WhiskeySockets/Baileys) — uma implementação em TypeScript que faz engenharia reversa do protocolo multi-dispositivo do WhatsApp Web. Quando você escaneia o QR code durante a configuração do OpenClaw, o Baileys emula um dispositivo vinculado na sua conta pessoal do WhatsApp.

Essa abordagem tem três problemas concretos.

**Os banimentos de conta estão aumentando.** A Meta detecta ativamente contas usando automação não oficial. Em uma [issue no GitHub do repositório do Baileys](https://github.com/WhiskeySockets/Baileys/issues/1869), vários desenvolvedores relataram banimentos em contas que estavam rodando bots por mais de 3 anos sem problemas — até serem banidos permanentemente de repente. A detecção está ficando mais rígida, não mais flexível.

**A quebra de protocolo é imprevisível.** O Baileys depende da engenharia reversa de um protocolo que a Meta pode alterar a qualquer momento. Quando o WhatsApp atualiza seus servidores, as conexões do Baileys podem entrar em loops de reconexão. Esses padrões anormais de conexão são exatamente o que os sistemas de detecção de banimento identificam.

**A política de 2026 da Meta endureceu as regras.** A partir de janeiro de 2026, a Meta bloqueia explicitamente chatbots de propósito geral no WhatsApp. Embora chatbots de operações empresariais (suporte ao cliente, rastreamento de pedidos, FAQs) continuem permitidos sob a API Business, a rede de fiscalização se ampliou. Usar uma biblioteca não oficial coloca sua conta em uma zona cinzenta que está cada vez mais se tornando uma zona vermelha.

Se o seu agente OpenClaw lida com algo importante — agendamentos, consultas empresariais, gatilhos de automação — perder sua conta do WhatsApp significa perder todo esse fluxo de trabalho da noite para o dia.

---

## O Que É o Pipes.bot e Como Ele Resolve Isso

O [Pipes.bot](https://www.pipes.bot/) é uma ponte gerenciada entre a API Cloud oficial do WhatsApp e agentes de IA auto-hospedados como o OpenClaw. Foi criado por Tulio Faria especificamente para resolver o problema descrito acima: dar aos desenvolvedores uma forma segura e compatível de conectar o WhatsApp aos seus agentes sem engenharia reversa.

Veja o que o Pipes.bot faz de diferente:

- **Usa a API Cloud oficial do WhatsApp da Meta** — sem engenharia reversa, sem violações de política

- **Conecta via WebSocket de saída** — sua instalação do OpenClaw faz uma conexão de saída para o Pipes.bot, o que significa que você nunca expõe portas nem o endereço IP do seu servidor

- **Enfileira mensagens** — se seu agente ficar offline, o Pipes.bot enfileira até 100 mensagens e as entrega quando ele reconectar

- **Suporta todos os tipos de mídia** — texto, imagens, documentos, áudio, vídeo — tudo que a API oficial suporta

- **Valida webhooks com assinaturas HMAC** — um hash secret garante que não haja adulteração man-in-the-middle nas mensagens recebidas

A principal diferença arquitetural é que seu gateway OpenClaw permanece completamente privado atrás do seu firewall. A conexão WebSocket é iniciada do seu lado, então não há nada a expor publicamente.

---

## Números Pool vs Traga Seu Próprio Número

O Pipes.bot oferece dois modos para conectar o WhatsApp ao OpenClaw. A escolha certa depende de você querer usar um número dedicado para seu agente ou seu próprio número comercial.

### Números Pool

Com Números Pool, o Pipes.bot fornece números de telefone que você ativa e vincula ao seu WhatsApp pessoal. O fluxo é simples: você salva um número pool do Pipes.bot como contato, envia uma mensagem para ativar o pareamento, e a partir desse ponto, toda mensagem que você enviar para esse número é encaminhada ao seu agente OpenClaw via webhook ou WebSocket.

**Quando usar Números Pool:**

- Você quer conectar seu agente pessoal de IA sem comprar um novo número

- Você precisa de múltiplos números para diferentes agentes ou automações (ex: um número para agendamentos, outro para anotações)

- Você quer testar a integração antes de se comprometer com um número comercial

- Você precisa de pontos de entrada separados para diferentes fluxos do n8n ou Make

Cada plano no Pipes.bot inclui um número definido de ativações de números pool. Se você tem 3 números pool, pode rotear mensagens para 3 agentes, automações ou instalações do OpenClaw diferentes — cada um com seu próprio endpoint de webhook ou WebSocket.

### Traga Seu Próprio Número (BYON)

Com BYON, você cadastra seu próprio número de telefone (ou os números dos seus clientes) na plataforma Pipes.bot. O número passa pelo fluxo de cadastro incorporado oficial da Meta — o mesmo processo baseado no domínio do Facebook que qualquer provedor de API WhatsApp Business usa. Isso significa total conformidade com os termos de serviço do WhatsApp.

**Quando usar BYON:**

- Você tem um número comercial dedicado para comunicação com clientes

- Você está construindo um produto SaaS que envia mensagens pelo WhatsApp em nome dos seus usuários

- Você precisa que seus clientes cadastrem seus próprios números através de um fluxo personalizado

- Você quer enviar confirmações de pedido, lembretes de agendamento ou mensagens de campanha de um número comercial reconhecido

O modo BYON também suporta cadastro white-label. Você pode personalizar a tela de cadastro com sua própria marca, logo e uma mensagem personalizada para que seus usuários finais reconheçam o fluxo como vindo da sua aplicação — não diretamente do Pipes.bot.

Após o cadastro de um número, o Pipes.bot envia uma notificação via webhook contendo o tipo de evento e o ID do número. A partir daí, você us

---

# Contato Pipes.bot - Ajuda com Integração WhatsApp e IA

URL: https://www.pipes.bot/pt-br/contact

> Entre em contato com a equipe do Pipes.bot para dúvidas, suporte técnico ou parcerias. Conecte agentes de IA ao WhatsApp.

## Contato

Adoraríamos ouvir você

Seja para tirar dúvidas sobre sua integração com o WhatsApp, explorar uma parceria ou entender melhor a plataforma, estamos aqui para ajudar. Escolha o melhor canal abaixo ou consulte nossas perguntas frequentes.

## Dúvidas Gerais

Perguntas, feedback ou oportunidades de parceria

[hi@pipes.bot](mailto:hi@pipes.bot)

## Suporte e Docs

Ajuda técnica, referência da API e guias de configuração

[docs.pipes.bot](https://docs.pipes.bot)

## Começar

Crie sua conta e conecte seu agente em minutos

[app.pipes.bot](https://app.pipes.bot)

## Perguntas Frequentes

### Qual o tempo de resposta dos emails?

Normalmente respondemos em até 24 horas em dias úteis. Para casos urgentes, inclua "URGENTE" no assunto do email.

### Vocês oferecem suporte técnico?

Sim. Consulte primeiro o [docs.pipes.bot](https://docs.pipes.bot) para guias de autoatendimento. Se precisar de ajuda, nos envie um email e ajudamos a resolver.

### Existe uma comunidade ou servidor no Discord?

Ainda não, mas está nos nossos planos. Por enquanto, entre em contato por email e acompanhe as novidades no nosso blog.

### Como reporto um bug?

Envie um email para [hi@pipes.bot](mailto:hi@pipes.bot) com os passos para reproduzir, o ID do seu pipe e as mensagens de erro. Levamos bugs a sério.

### Vocês estão abertos a parcerias ou integrações?

Com certeza. Se você está construindo uma plataforma de IA, ferramenta de automação ou produto SaaS — queremos conversar. Envie um email com os detalhes da sua ideia.

### Qual o tempo de resposta para problemas técnicos?

Para problemas técnicos que afetam tráfego em produção, priorizamos o atendimento e normalmente respondemos em poucas horas durante dias úteis. Inclua o ID do seu pipe e logs de erro relevantes para agilizar a resolução.

**ID49 Digital LTDA** — Pipes.bot

---

# Pipes.bot - A Ponte Segura de WhatsApp para Agentes de IA

URL: https://www.pipes.bot/pt-br

> Conecte seu agente de IA ao WhatsApp em 5 minutos usando a API Cloud oficial da Meta. Sem Baileys, sem portas expostas, sem risco de banimento.

Construído na API Cloud Oficial do WhatsApp da Meta

## Fale com Seu Agente de IA no WhatsApp — Sem Ser Banido

Conecte seu agente de IA, automação ou app ao WhatsApp em 5 minutos. Sem Baileys. Sem portas expostas. Sem risco de conta.

[Começar →](https://app.pipes.bot) ▶
Veja como funciona (2 min)

Painel Pipes.bot

Status

Online

Última Sincronização

Agora mesmo

$ Terminal

> openclaw plugins install @pipes.bot/pipes-bot-channel
Plugin instalado com sucesso

> pipes-bot --configure [CHAVE_OCULTA]

Preview WhatsApp Ativo

E aí, qual minha agenda de hoje?

Você tem 3 reuniões hoje. Começando às 10h com o time de marketing.

## Rodando Seu Agente no WhatsApp Não Deveria Parecer Desarmar uma Bomba

A Realidade do Baileys:

### Banimentos de conta

O WhatsApp detecta clientes não oficiais e bloqueia seu número

### Sessões que caem

QR codes expiram, mensagens desaparecem no limbo

### Dores de cabeça com rede

Cloudflare Tunnel? Tailscale? ngrok? Só para receber uma mensagem?

### Seu número em risco

Um erro e você perde ele para sempre

"Você criou seu agente de IA para facilitar a vida. Colocá-lo no WhatsApp não deveria ser a parte difícil."

## Uma Conexão. Acesso Total ao WhatsApp.

Pipes.bot é uma ponte gerenciada entre a API Cloud oficial do WhatsApp e seu agente de IA ou aplicação auto-hospedada.

Como funciona

Seu Agente

conecta de saída →

Pipes.bot

→

API Cloud WhatsApp

01

### Fica Privado

Seu agente nunca é exposto à internet pública.

02

### Fica Seguro

Sem engenharia reversa significa sem banimentos da Meta.

03

### Simplesmente Funciona

Entrega confiável de mensagens mesmo através de NATs.

[Começar →](https://app.pipes.bot)

## Por que Pipes.bot?

### API Oficial, Risco Zero

Usamos a API Cloud do WhatsApp da Meta — a mesma infraestrutura que empresas confiam. Sem engenharia reversa. Sem violações de política. Sem surpresas.

### Seu Agente Fica Privado

Configurações tradicionais exigem expor seu gateway à internet. Com o Pipes.bot, seu plugin conecta de dentro para fora. Funciona através de NAT, firewalls, qualquer coisa.

### Mensagens Nunca se Perdem

Agente offline? Enfileiramos até 100 mensagens e entregamos quando você reconectar. Você ainda recebe uma notificação no WhatsApp quando seu agente cai.

### Webhooks e Automações

Conecte n8n, Make, Zapier ou qualquer endpoint HTTP. O Pipes.bot envia mensagens via POST para sua URL, e você responde via nossa API REST. Sem plugin necessário.

## No Ar em 5 Minutos

1

### Cadastre-se

Crie sua conta no Pipes.bot

2

### Escolha seu modo

Instale o plugin OpenClaw para agentes de IA, configure uma URL de webhook para automações, ou crie um App BYON para produtos customizados

3

### Adicione sua chave API

Cole sua chave única na configuração

4

### Ative seu número

Envie um código para um número pool via WhatsApp — ou conecte o seu próprio via BYON

5

### Comece a conversar

Seu agente ou app agora está ativo no WhatsApp

[Começar →](https://app.pipes.bot)

## Confiado por Usuários OpenClaw

"
"Eu estava apavorado de perder meu número de telefone para um banimento do Baileys. O Pipes.bot resolveu isso em uma tarde."

MR

Marcus R.

Entusiasta de Produtividade Pessoal

"
"Finalmente coloquei minha IA doméstica no WhatsApp sem abrir uma única porta. O recurso de fila me salvou quando meu Pi ficou offline."

ST

Sofia T.

Entusiasta de IA auto-hospedada

### Estatísticas do Acesso Antecipado

99.9%

Taxa de entrega de mensagens

<500ms

Latência mediana

0

Banimentos de conta

## Preços Simples e Transparentes

### Starter

$5 /mês

- 1 número Pool
- Mensagens ilimitadas
- Fila offline
- Suporte comunidade
[Começar →](https://app.pipes.bot)

Mais Popular

### Pro

$9 /mês

- 3 números Pool
- Mensagens ilimitadas
- BYON disponível
- Fila offline
- Suporte por email
[Começar →](https://app.pipes.bot)

### Pro+

$19 /mês

- 5 números Pool
- Mensagens ilimitadas
- BYON disponível
- Fila offline
- Suporte prioritário
[Começar →](https://app.pipes.bot)

BYON add-on: +$5/número/mês nos planos Pro e Pro+

## Perguntas Frequentes

Meu número do WhatsApp vai ser banido? +
Não. Usamos a API Cloud oficial da Meta — a mesma infraestrutura usada por empresas no mundo todo. Não há engenharia reversa ou violações de política envolvidas.

Preciso expor meu agente à internet? +
Não. Nosso plugin faz uma conexão de saída da sua rede. Seu gateway fica completamente privado atrás do seu firewall.

O que acontece se meu agente ficar offline? +
Enfileiramos suas mensagens (até 100) e entregamos quando seu agente reconectar. Você também recebe uma notificação no WhatsApp para saber o que está acontecendo.

Posso usar meu próprio número business do WhatsApp? +
Sim, nos planos Pro e Pro+. Suportamos "Traga Seu Próprio Número" (BYON) através do fluxo de Embedded Signup da Meta por +$5/número/mês.

Isso funciona com n8n, Make ou Zapier? +
Com certeza. Use o modo webhook — enviamos mensagens diretamente via POST para sua URL, e você responde via nossa API REST. Sem plugin necessário, funciona com qualquer endpoint HTTP.

---

# Política de Privacidade - Pipes.bot Proxy API WhatsApp

URL: https://www.pipes.bot/pt-br/privacy-policy

> Política de Privacidade do Pipes.bot, o proxy gerenciado de API Cloud do WhatsApp para agentes de IA. Saiba como coletamos, usamos e protegemos seus dados.

## Política de Privacidade

Pipes.bot — Proxy de API Cloud do WhatsApp para Agentes de IA

**Data de Vigência:** 2 de fevereiro de 2026

**Última Atualização:** 2 de fevereiro de 2026

## 1. Introdução

O Pipes.bot é operado pela **ID49 Digital LTDA** ("nós", "nos" ou "nosso"). Fornecemos um serviço de proxy gerenciado para a API Cloud do WhatsApp que conecta agentes de IA auto-hospedados ao WhatsApp através da API Business oficial da Meta. Esta Política de Privacidade explica como coletamos, usamos, armazenamos e protegemos suas informações quando você usa nossa plataforma, incluindo nosso site, painel, APIs e plugin Clawdbot (coletivamente, o "Serviço").

Ao criar uma conta ou usar o Serviço, você concorda com as práticas descritas nesta política. Se você não concordar, por favor não use o Serviço.

## 2. Informações que Coletamos

### 2.1 Informações da Conta

Quando você se registra no Pipes.bot, coletamos:

- **Endereço de e-mail** — usado para autenticação, recuperação de conta e comunicações de serviço.
- **Número de telefone pessoal** (no formato E.164) — usado para rotear mensagens do WhatsApp entre você e seu agente de IA. Este número é armazenado como seu fromNumber e vinculado à sua conta tenant.

### 2.2 Dados de Configuração do Serviço

Conforme você configura e usa o Serviço, armazenamos:

- **Chaves de API** — com hash e armazenadas de forma segura. Mantemos apenas um prefixo curto (ex: pk_live_abc...) para fins de exibição. A chave completa nunca é armazenada em texto simples.
- **Ativações de números pool** — registros vinculando seu número de telefone a números pool específicos, incluindo rótulos opcionais que você atribui (ex: "trabalho", "pessoal").
- **Configuração de webhook** — se você usar o modo Webhook, armazenamos sua URL de webhook e um segredo de webhook que você fornece para verificação de assinatura.
- **Preferência de modo de entrega** — se você usa entrega via WebSocket (plugin Clawdbot) ou Webhook (n8n, Make, Zapier, etc.).
- **Detalhes de conexão BYON** (se aplicável) — ID da Conta Business do WhatsApp, ID do número de telefone, tokens de acesso OAuth (criptografados em repouso), e seu modo de resposta escolhido (OWNER_ONLY ou ALL_NUMBERS).

### 2.3 Dados de Mensagens

O Pipes.bot processa mensagens do WhatsApp como um relé entre você e seu agente de IA. Nosso tratamento de mensagens é projetado para minimizar a retenção de dados:

- **Mensagens em trânsito** não são persistidas em nenhum banco de dados.
- **Mensagens enfileiradas enquanto seu agente está offline** são mantidas temporariamente em nossos servidores por no máximo 24 horas ou até serem entregues, o que ocorrer primeiro. Mensagens enfileiradas são excluídas imediatamente após a entrega ou expiração.
- **O conteúdo das mensagens nunca é registrado.** Nossos logs de aplicação registram metadados (ex: IDs de mensagens, timestamps, status de entrega) mas nunca o texto ou conteúdo de mídia de suas mensagens.

### 2.4 Dados Técnicos e de Uso

Coletamos automaticamente informações técnicas limitadas para operar e melhorar o Serviço:

- **Metadados de conexão** — timestamps de quando seu plugin conecta ou desconecta, duração da conexão e status online/offline.
- **Contagens de volume de mensagens** — contagens agregadas de mensagens enviadas e recebidas por tenant, usadas para limites de uso e análises. Essas contagens não incluem conteúdo de mensagens.
- **Logs de erros e entregas** — registros de entregas de mensagens falhas ou tentativas de entrega de webhook, incluindo códigos de status HTTP e tipos de erro (mas não conteúdo de mensagens).
- **Informações de versão do plugin** — a versão do seu plugin Clawdbot e gateway Clawdbot, enviadas durante a autenticação WebSocket.

### 2.5 Informações que NÃO Coletamos

- Não coletamos seu nome, endereço físico, dados de cartão de pagamento (até a implementação de cobrança), ou qualquer informação demográfica.
- Não lemos, analisamos, treinamos ou armazenamos o conteúdo de suas mensagens do WhatsApp além do enfileiramento temporário descrito acima.
- Não usamos cookies para publicidade ou rastreamento. Nosso painel pode usar cookies de sessão estritamente para autenticação.

## 3. Como Usamos Suas Informações

Usamos as informações que coletamos para os seguintes propósitos:

Propósito

Dados Utilizados

**Fornecer o Serviço**

E-mail, número de telefone, chaves de API, ativações, configuração de webhook

**Rotear mensagens**

Número de telefone, ativações de números pool, configuração BYON

**Enfileirar mensagens offline**

Conteúdo de mensagens (temporariamente, apenas em memória)

**Autenticar você**

E-mail, tokens de sessão, hashes de chaves de API

**Notificar sobre status do agente**

Número de telefone (para enviar notificações do WhatsApp quando seu agente fica offline/online)

**Monitorar saúde do serviço**

Metadados de conexão, logs de erros, contagens de volume de mensagens

**Aplicar limites de uso**

Contagens de volume de mensagens, nível do plano

**Melhorar o Serviço**

Métricas de uso agregadas e anonimizadas

**Comunicar com você**

E-mail (atualizações de serviço, alertas de segurança)

**Não** usamos seus dados para publicidade, perfilamento ou venda para terceiros.

## 4. Como Compartilhamos Suas Informações

### 4.1 Meta Platforms (WhatsApp)

Para entregar mensagens via WhatsApp, interagimos com a API Cloud do WhatsApp da Meta. Isso significa:

- Seu número de telefone e conteúdo de mensagens são transmitidos para os servidores da Meta como parte do fluxo padrão de entrega de mensagens do WhatsApp.
- Números pool são registrados sob a Conta Business do WhatsApp (WABA) do Pipes.bot. Números BYON são registrados sob sua própria WABA.
- O uso desses dados pela Meta é regido pela [Política de Privacidade da Meta](https://www.facebook.com/privacy/policy/) e pelos [Termos de Negócios do WhatsApp](https://www.whatsapp.com/legal/business-terms).

### 4.2 Provedores de Infraestrutura

Nosso Serviço depende dos seguintes provedores de infraestrutura, que podem processar dados em nosso nome:

- **CockroachDB (Cockroach Labs)** — hospeda nosso banco de dados. Regido pela [Política de Privacidade da Cockroach Labs](https://www.cockroachlabs.com/privacy/).
- **Amazon Web Services (AWS)** — fornece armazenamento de objetos (S3). Regido pelo [Aviso de Privacidade da AWS](https://aws.amazon.com/privacy/).

Esses provedores atuam como processadores de dados sob nossas instruções e são contratualmente obrigados a proteger seus dados.

### 4.3 Seu Agente de IA

Mensagens recebidas em seu nome são encaminhadas para sua instância Clawdbot auto-hospedada (via WebSocket ou webhook). O Pipes.bot não controla como seu agente de IA processa ou armazena esses dados. Você é responsável pelas práticas de privacidade do seu próprio agente de IA.

### 4.4 Requisitos Legais

Podemos divulgar suas informações se exigido por lei ou em resposta a processo legal válido, como uma ordem judicial ou intimação. Tentaremos notificá-lo antes de divulgar suas informações, a menos que proibido por lei.

### 4.5 Não Venda de Dados

Não vendemos, alugamos ou comercializamos suas informações pessoais para terceiros para qualquer finalidade.

## 5. Armazenamento e Segurança de Dados

### 5.1 Infraestrutura

Componente

Provedor

Finalidade

Banco de dados

CockroachDB Serverless

Dados de conta, ativações, hashes de chaves de API

Armazenamento de objetos

Amazon S3

Armazenamento de arquivos e mídia

Conexões em tempo real

Servidores Pipes.bot

Gerenciamento de WebSocket, fila temporária de mensagens

Os dados são armazenados no CockroachDB Serverless (que fornece criptografia em repouso e em trânsito), Amazon S3 (com criptografia do lado do servidor), e nossos próprios servidores para conexões WebSocket em tempo real.

### 5.2 Medidas de Segurança

- **Chaves de API** são hashadas antes do armazenamento. A chave original é mostrada apenas uma vez na criação e nunca é armazenada ou recuperável.
- **Tokens OAuth BYON** são criptografado

---

# Termos de Serviço - Pipes.bot Proxy API WhatsApp

URL: https://www.pipes.bot/pt-br/terms-of-service

> Termos de Serviço do Pipes.bot, o proxy gerenciado de API Cloud do WhatsApp para agentes de IA. Leia sobre políticas de uso, cobrança e seus direitos.

## Termos de Serviço

Pipes.bot — Proxy de API Cloud do WhatsApp para Agentes de IA

**Data de Vigência:** 2 de fevereiro de 2026

**Última Atualização:** 2 de fevereiro de 2026

## 1. Introdução

Estes Termos de Serviço ("Termos") regem seu acesso e uso da plataforma Pipes.bot ("Serviço"), operada pela ID49 Digital LTDA ("Pipes.bot", "nós", "nos" ou "nosso"). O Serviço fornece um proxy gerenciado entre a API Cloud oficial do WhatsApp da Meta e agentes de IA auto-hospedados, permitindo roteamento de mensagens via modos de entrega WebSocket e Webhook.

Ao criar uma conta ou usar o Serviço, você concorda em ficar vinculado a estes Termos. Se você não concordar, não use o Serviço.

## 2. Definições

- **"Tenant"** significa uma conta de cliente registrada no Pipes.bot.
- **"Número Pool"** significa um número de telefone WhatsApp Business de propriedade e gerenciado pelo Pipes.bot, compartilhado entre usuários e roteado pelo número de telefone pessoal de cada usuário.
- **"BYON" (Bring Your Own Number / Traga Seu Próprio Número)** significa um número de telefone WhatsApp Business de sua propriedade e conectado ao Pipes.bot via fluxo de Embedded Signup da Meta.
- **"Plugin"** significa o plugin de canal Clawdbot (@pipes.bot/channel) que estabelece uma conexão WebSocket entre seu agente auto-hospedado e o Serviço.
- **"Chave de API"** significa a credencial de autenticação emitida para você para conectar o Plugin ou API REST ao Serviço.
- **"Código de Ativação"** significa o código único gerado pelo Serviço para vincular seu número de telefone pessoal a um Número Pool.
- **"Modo Webhook"** significa a configuração de entrega onde mensagens recebidas são encaminhadas para uma URL que você especifica via HTTP POST.
- **"Modo WebSocket"** significa a configuração de entrega onde mensagens recebidas são encaminhadas para seu agente via uma conexão WebSocket persistente.
- **"Modo de Entrega"** significa tanto o Modo Webhook quanto o Modo WebSocket.

## 3. Elegibilidade

Você deve ter pelo menos 18 anos de idade e capacidade legal para celebrar estes Termos. Se você usar o Serviço em nome de uma organização, você declara que tem autoridade para vincular essa organização a estes Termos.

## 4. Registro de Conta

4.1. Você deve se registrar com um endereço de e-mail válido e verificá-lo através do magic link que enviamos.

4.2. Você é responsável por manter a confidencialidade das credenciais da sua conta e Chaves de API. Você deve nos notificar imediatamente se suspeitar de acesso não autorizado à sua conta.

4.3. Cada indivíduo pode manter apenas uma conta. Cada conta corresponde a um Tenant.

4.4. Você deve fornecer informações de registro precisas e completas e mantê-las atualizadas.

## 5. Descrição do Serviço

### 5.1 Funcionalidade Principal

O Pipes.bot atua como uma ponte gerenciada entre a API Cloud do WhatsApp da Meta e seu agente de IA ou plataforma de automação. O Serviço recebe mensagens do WhatsApp em seu nome e as entrega ao seu agente ou endpoint de webhook. Respostas do seu agente são enviadas de volta ao usuário do WhatsApp através da API da Meta.

### 5.2 Números Pool

Números Pool são números de telefone WhatsApp Business de propriedade e operados pelo Pipes.bot. Você ativa um Número Pool gerando um Código de Ativação no seu painel, depois enviando esse código para o Número Pool via WhatsApp do seu telefone pessoal. Isso vincula seu número de telefone pessoal àquele Número Pool para roteamento de mensagens.

O número de Números Pool que você pode ativar simultaneamente depende do seu plano de assinatura.

### 5.3 BYON (Traga Seu Próprio Número)

Se disponível no seu plano, você pode conectar sua própria Conta Business do WhatsApp ao Serviço via Embedded Signup da Meta. Ao usar BYON, você mantém a propriedade do seu número de telefone e perfil WhatsApp Business. O Pipes.bot atua como intermediário técnico para rotear mensagens.

Conexões BYON suportam dois modos de resposta:

- **Apenas Proprietário (padrão):** O Serviço processa apenas mensagens enviadas do seu número de telefone pessoal registrado. Mensagens de outros remetentes são ignoradas.
- **Todos os Números:** O Serviço processa mensagens de qualquer remetente. Este modo é destinado apenas para números de agente de IA dedicados.

Você é o único responsável por garantir que seu uso de BYON esteja em conformidade com a Política de Negócios do WhatsApp da Meta e todas as leis aplicáveis, incluindo, mas não se limitando a, obter quaisquer consentimentos necessários dos destinatários das mensagens.

### 5.4 Modos de Entrega

Você pode escolher receber mensagens via WebSocket (para conexões de agente em tempo real) ou Webhook (para integração com plataformas como n8n, Make ou Zapier). Você configura seu Modo de Entrega preferido no painel.

### 5.5 Fila Offline

Quando seu agente ou endpoint de webhook está indisponível, o Serviço enfileirará mensagens recebidas por até 24 horas (máximo de 100 mensagens). Mensagens enfileiradas são entregues quando sua conexão é restaurada. Mensagens que excedem o limite da fila ou expiram após 24 horas são descartadas e não podem ser recuperadas.

## 6. Uso Aceitável

### 6.1 Você concorda em usar o Serviço apenas para fins lícitos e em conformidade com:

- Estes Termos
- Política de Negócios do WhatsApp e Política de Comércio do WhatsApp da Meta
- Termos de Plataforma da Meta
- Todas as leis e regulamentos locais, estaduais, nacionais e internacionais aplicáveis

### 6.2 Você NÃO deve usar o Serviço para:

- Enviar spam, mensagens não solicitadas ou mensagens promocionais em massa
- Assediar, ameaçar, difamar ou abusar de qualquer pessoa
- Personificar qualquer pessoa ou entidade, ou deturpar sua afiliação
- Transmitir malware, vírus ou qualquer código prejudicial
- Interferir ou interromper o Serviço ou sua infraestrutura
- Tentar obter acesso não autorizado ao Serviço, outras contas ou sistemas relacionados
- Contornar quaisquer limites de taxa, cotas de uso ou restrições técnicas
- Usar meios automatizados para criar contas ou gerar Códigos de Ativação
- Revender ou sublicenciar acesso ao Serviço sem um acordo escrito separado (ver White Label)
- Violar os direitos de propriedade intelectual de terceiros
- Enviar mensagens que contenham conteúdo ilegal, incluindo, mas não se limitando a, conteúdo que explore menores, promova violência ou facilite transações ilegais

### 6.3 Conteúdo de Mensagens

Você é o único responsável por todo o conteúdo enviado através do Serviço, incluindo mensagens geradas pelo seu agente de IA. O Pipes.bot não monitora, revisa ou modera o conteúdo das mensagens, mas reserva-se o direito de suspender ou encerrar contas que violem estes Termos ou a lei aplicável ao tomar conhecimento de tais violações.

### 6.4 Responsabilidade do Agente de IA

Se você conectar um agente de IA ao Serviço, você é responsável pelo comportamento e saída desse agente. Você deve garantir que seu agente não gere conteúdo que viole estes Termos, as políticas da Meta ou a lei aplicável. Você reconhece que respostas geradas por IA podem ocasionalmente produzir conteúdo impreciso, inadequado ou inesperado, e você aceita total responsabilidade por gerenciar esse risco.

## 7. Planos e Cobrança

### 7.1 Planos de Assinatura

O Serviço oferece múltiplos níveis de assinatura com conjuntos de recursos e limites de uso variados. Detalhes atuais dos planos, incluindo preços, estão disponíveis em nosso site. Reservamo-nos o direito de modificar recursos e preços dos planos com 30 dias de aviso prévio.

### 7.2 Plano Gratuito

O plano Gratuito é fornecido sem custo com funcionalidade limitada (um Número Pool e limites diários de mensagens). Reservamo-nos o direito de modificar ou descontinuar o plano Gratuito a qualquer momento.

### 7.3 Planos Pagos

Assinaturas pagas são cobradas mensalmente com antecedência. O pagamento é processado através do nosso provedor de pagamento terceirizado. Você concorda em fornecer informações de pagamento válidas e autorizar cobr

---

# Casos de Uso - Conecte IA ao WhatsApp

URL: https://www.pipes.bot/pt-br/use-cases

> Descubra como equipes usam o Pipes.bot para conectar agentes de IA, automações e apps ao WhatsApp pela API Cloud oficial da Meta.

Casos de Uso

## O Que Você Pode Construir com o Pipes.bot?

De assistentes de IA a automações de fluxo, o Pipes.bot conecta qualquer coisa ao WhatsApp através da API oficial da Meta.

O Pipes.bot funciona com qualquer stack. Use qualquer linguagem, qualquer modelo de IA, qualquer provedor de hospedagem. Nossa arquitetura baseada em webhooks e o sistema de plugins OpenClaw garantem que você nunca fica preso. Envie um webhook, receba mensagens. Funciona com Python, Node, Go, PHP — o que seu time já usa.

## Assistente Pessoal de IA

Conecte seu agente de IA auto-hospedado ao WhatsApp e converse com ele de qualquer lugar. Obtenha respostas, gerencie tarefas e automatize sua rotina.

## Bot de Suporte ao Cliente

Construa um agente de suporte com IA que atende consultas de clientes 24/7 no WhatsApp. Encaminhe questões complexas para humanos quando necessário.

## Automação de Fluxos

Integre com n8n, Make ou Zapier para disparar automações a partir de mensagens do WhatsApp. Atualize planilhas, crie tickets, envie notificações.

## Automação Residencial

Controle sua casa inteligente pelo WhatsApp. Acenda luzes, verifique câmeras, ajuste termostatos — tudo enviando mensagens para seu agente de IA.

## Notificações para Equipe

Envie alertas em tempo real para sua equipe via WhatsApp. Servidor caiu? Build falhou? Novo lead? Sua equipe sabe instantaneamente.

## Agendamento de Consultas

Permita que clientes agendem, remarquem e cancelem compromissos pelo WhatsApp. Sincronize com Google Calendar ou qualquer sistema de agendamento.

## Atualizações de E-Commerce

Envie confirmações de pedido, atualizações de envio e notificações de entrega via WhatsApp. Mantenha clientes informados automaticamente.

## Bot Interno da Empresa

Implante um assistente de IA interno que responde perguntas do RH, verifica saldo de férias ou consulta políticas da empresa — tudo via WhatsApp.

## Pronto para Conectar Seu Agente?

Comece em 5 minutos. Sem Baileys. Sem portas expostas. Sem risco de conta.

[Começar →](https://app.pipes.bot)

---

# Terms of Service - Pipes.bot WhatsApp API Proxy

URL: https://www.pipes.bot/terms-of-service

> Terms of Service for Pipes.bot, the managed WhatsApp Cloud API proxy for AI agents. Read about usage policies, billing, and your rights.

## Terms of Service

Pipes.bot — WhatsApp Cloud API Proxy for AI Agents

**Effective Date:** February 2, 2026

**Last Updated:** February 2, 2026

## 1. Introduction

These Terms of Service ("Terms") govern your access to and use of the Pipes.bot platform ("Service"), operated by ID49 Digital LLC ("Pipes.bot," "we," "us," or "our"). The Service provides a managed proxy between the official Meta WhatsApp Cloud API and self-hosted AI agents, enabling message routing via WebSocket and Webhook delivery modes.

By creating an account or using the Service, you agree to be bound by these Terms. If you do not agree, do not use the Service.

## 2. Definitions

- **"Tenant"** means a registered Pipes.bot customer account.
- **"Pool Number"** means a WhatsApp Business phone number owned and managed by Pipes.bot, shared across users and routed by each user's personal phone number.
- **"BYON" (Bring Your Own Number)** means a WhatsApp Business phone number owned by you and connected to Pipes.bot via Meta's Embedded Signup flow.
- **"Plugin"** means the Clawdbot channel plugin (@pipes.bot/channel) that establishes a WebSocket connection between your self-hosted agent and the Service.
- **"API Key"** means the authentication credential issued to you for connecting the Plugin or REST API to the Service.
- **"Activation Code"** means the one-time code generated by the Service to link your personal phone number to a Pool Number.
- **"Webhook Mode"** means the delivery configuration where incoming messages are forwarded to a URL you specify via HTTP POST.
- **"WebSocket Mode"** means the delivery configuration where incoming messages are forwarded to your agent via a persistent WebSocket connection.
- **"Delivery Mode"** means either Webhook Mode or WebSocket Mode.

## 3. Eligibility

You must be at least 18 years old and have the legal capacity to enter into these Terms. If you use the Service on behalf of an organization, you represent that you have the authority to bind that organization to these Terms.

## 4. Account Registration

4.1. You must register with a valid email address and verify it via the magic link we send you.

4.2. You are responsible for maintaining the confidentiality of your account credentials and API Keys. You must notify us immediately if you suspect unauthorized access to your account.

4.3. Each individual may maintain only one account. Each account corresponds to one Tenant.

4.4. You must provide accurate and complete registration information and keep it up to date.

## 5. Service Description

### 5.1 Core Functionality

Pipes.bot acts as a managed bridge between the Meta WhatsApp Cloud API and your AI agent or automation platform. The Service receives messages from WhatsApp on your behalf and delivers them to your agent or webhook endpoint. Replies from your agent are sent back to the WhatsApp user through the Meta API.

### 5.2 Pool Numbers

Pool Numbers are WhatsApp Business phone numbers owned and operated by Pipes.bot. You activate a Pool Number by generating an Activation Code in your dashboard, then sending that code to the Pool Number via WhatsApp from your personal phone. This links your personal phone number to that Pool Number for message routing.

The number of Pool Numbers you may activate simultaneously depends on your subscription plan.

### 5.3 BYON (Bring Your Own Number)

If available under your plan, you may connect your own WhatsApp Business Account to the Service via Meta's Embedded Signup. When using BYON, you retain ownership of your phone number and WhatsApp Business profile. Pipes.bot acts as a technical intermediary to route messages.

BYON connections support two response modes:

- **Owner Only (default):** The Service only processes messages sent from your registered personal phone number. Messages from other senders are ignored.
- **All Numbers:** The Service processes messages from any sender. This mode is intended for dedicated AI agent numbers only.

You are solely responsible for ensuring that your use of BYON complies with Meta's WhatsApp Business Policy and all applicable laws, including but not limited to obtaining any required consents from message recipients.

### 5.4 Delivery Modes

You may choose to receive messages via WebSocket (for real-time agent connections) or Webhook (for integration with platforms such as n8n, Make, or Zapier). You configure your preferred Delivery Mode in the dashboard.

### 5.5 Offline Queue

When your agent or webhook endpoint is unavailable, the Service will queue incoming messages for up to 24 hours (maximum 100 messages). Queued messages are delivered when your connection is restored. Messages that exceed the queue limit or expire after 24 hours are discarded and cannot be recovered.

## 6. Acceptable Use

### 6.1 You agree to use the Service only for lawful purposes and in compliance with:

- These Terms
- Meta's WhatsApp Business Policy and WhatsApp Commerce Policy
- Meta's Platform Terms
- All applicable local, state, national, and international laws and regulations

### 6.2 You shall NOT use the Service to:

- Send spam, unsolicited messages, or bulk promotional messages
- Harass, threaten, defame, or abuse any person
- Impersonate any person or entity, or misrepresent your affiliation
- Transmit malware, viruses, or any harmful code
- Interfere with or disrupt the Service or its infrastructure
- Attempt to gain unauthorized access to the Service, other accounts, or related systems
- Circumvent any rate limits, usage quotas, or technical restrictions
- Use automated means to create accounts or generate Activation Codes
- Resell or sublicense access to the Service without a separate written agreement (see White Label)
- Violate the intellectual property rights of any third party
- Send messages that contain illegal content, including but not limited to content that exploits minors, promotes violence, or facilitates illegal transactions

### 6.3 Message Content

You are solely responsible for all content sent through the Service, including messages generated by your AI agent. Pipes.bot does not monitor, review, or moderate message content, but reserves the right to suspend or terminate accounts that violate these Terms or applicable law upon becoming aware of such violations.

### 6.4 AI Agent Responsibility

If you connect an AI agent to the Service, you are responsible for the behavior and output of that agent. You must ensure your agent does not generate content that violates these Terms, Meta's policies, or applicable law. You acknowledge that AI-generated responses may occasionally produce inaccurate, inappropriate, or unexpected content, and you accept full responsibility for managing this risk.

## 7. Plans and Billing

### 7.1 Subscription Plans

The Service offers multiple subscription tiers with varying feature sets and usage limits. Current plan details, including pricing, are available on our website. We reserve the right to modify plan features and pricing with 30 days' prior notice.

### 7.2 Free Tier

The Free tier is provided at no cost with limited functionality (one Pool Number and daily message limits). We reserve the right to modify or discontinue the Free tier at any time.

### 7.3 Paid Plans

Paid subscriptions are billed monthly in advance. Payment is processed through our third-party payment provider. You agree to provide valid payment information and authorize recurring charges.

### 7.4 Meta Conversation Charges

Meta may charge fees based on WhatsApp conversation categories (user-initiated, business-initiated, etc.). These charges are separate from Pipes.bot subscription fees and are your responsibility. For BYON users, Meta charges are billed directly to your Meta Business account. For Pool Number users, any applicable Meta conversation charges may be passed through to you.

### 7.5 Cancellation and Refunds

You may cancel your subscription at any time through the dashboard. Upon cancellation, your paid plan remains active until the end o

---

# Use Cases - Connect AI Agents to WhatsApp via Pipes.bot

URL: https://www.pipes.bot/use-cases

> Discover how teams use Pipes.bot to connect AI agents, automations, and apps to WhatsApp through Meta

Use Cases

## What Can You Build with Pipes.bot?

From AI assistants to workflow automations, Pipes.bot connects anything to WhatsApp through Meta's official API.

Pipes.bot is stack-agnostic. Use any language, any AI model, any hosting provider. Our webhook-based architecture and OpenClaw plugin system mean you're never locked in. Send a webhook, receive messages. It works with Python, Node, Go, PHP — whatever your team already runs.

## AI Personal Assistant

Connect your self-hosted AI agent to WhatsApp and chat with it from anywhere. Get answers, manage tasks, and automate your daily routine.

## Customer Support Bot

Build an AI-powered support agent that handles customer inquiries 24/7 on WhatsApp. Route complex issues to humans when needed.

## Workflow Automation

Integrate with n8n, Make, or Zapier to trigger automations from WhatsApp messages. Update spreadsheets, create tickets, send notifications.

## Home Automation

Control your smart home through WhatsApp. Turn on lights, check cameras, adjust thermostats — all by messaging your AI agent.

## Team Notifications

Send real-time alerts to your team via WhatsApp. Server down? Build failed? New lead? Your team knows instantly.

## Appointment Booking

Let customers book, reschedule, and cancel appointments through WhatsApp. Sync with Google Calendar or any scheduling system.

## E-Commerce Updates

Send order confirmations, shipping updates, and delivery notifications via WhatsApp. Keep customers in the loop automatically.

## Internal Company Bot

Deploy an internal AI assistant that answers HR questions, checks PTO balances, or looks up company policies — all via WhatsApp.

## Ready to Connect Your Agent?

Get started in 5 minutes. No Baileys. No exposed ports. No account risk.

[Get Started →](https://app.pipes.bot)

---

# Getting Started: AI Agent on WhatsApp

Source: blog/en/getting-started-with-pipes-bot.mdx

> Learn how to connect your self-hosted AI agent to WhatsApp using Pipes.bot's official Cloud API bridge. No Baileys, no exposed ports, no risk.

### Why Pipes.bot?

If you've ever tried to connect an AI agent to WhatsApp, you've probably run into the Baileys dilemma: unofficial libraries that risk getting your phone number banned, require exposed ports, and drop sessions without warning.

Pipes.bot solves this by providing a managed bridge to Meta's **official WhatsApp Cloud API**. Your agent connects outbound to our service — no open ports, no reverse engineering, no policy violations.

### Prerequisites

Before you begin, make sure you have:

- A Pipes.bot account ([sign up here](https://app.pipes.bot))
- A self-hosted AI agent (OpenClaw, LangChain, custom, etc.) **or** a webhook endpoint (n8n, Make, Zapier)
- Your personal WhatsApp number for activation

### Step 1: Choose Your Delivery Mode

Pipes.bot supports two ways to receive messages:

- **WebSocket Mode** — Install the OpenClaw plugin for real-time, bidirectional communication with your AI agent.
- **Webhook Mode** — Point us at any HTTP endpoint and we'll POST messages to it. Perfect for n8n, Make, Zapier, or custom APIs.

### Step 2: Get Your API Key

Head to your [Pipes.bot dashboard](https://app.pipes.bot) and generate an API key. Keep it safe — it's shown only once.

### Step 3: Activate a Number

In the dashboard, generate an activation code and send it via WhatsApp to one of our pool numbers. This links your personal number to the pool number for message routing.

### Step 4: Connect Your Agent

**For WebSocket mode:**

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

Configure the plugin with your API key, and you're live.

**For Webhook mode:**

Set your webhook URL in the dashboard. We'll start POSTing messages to your endpoint immediately.

### Step 5: Start Chatting

Send a message to your pool number from WhatsApp. Your agent receives it, processes it, and replies — all through Meta's official API.

### What About Offline Messages?

If your agent goes down, Pipes.bot queues up to 100 messages and delivers them when you reconnect. You'll even get a WhatsApp notification so you know your agent is offline.

### Next Steps

- Explore **BYON (Bring Your Own Number)** on Pro plans to use your own WhatsApp Business number
- Check out the [docs](https://docs.pipes.bot) for API reference and advanced configuration
- Join the community for tips and support


---

# WhatsApp API OpenClaw: Official API Setup

Source: blog/en/whatsapp-api-openclaw.mdx

> Integrate WhatsApp Official API with OpenClaw using Pipes.bot. No Baileys risks, no exposed ports — a secure bridge for your AI agent.

### How to Use WhatsApp Official API with OpenClaw

If you run an OpenClaw installation and want to connect it to WhatsApp without risking your account, this guide is for you. The default OpenClaw WhatsApp channel relies on Baileys — an unofficial library that reverse-engineers the WhatsApp Web protocol. While it works, it violates Meta's Terms of Service and can lead to permanent bans.

There is a better path. By using the **WhatsApp Official API with OpenClaw** through a bridge service like [Pipes.bot](https://www.pipes.bot/), you get a fully compliant, reliable connection that requires no open ports and no unofficial libraries. This article walks you through how it works, why it matters, and how to set it up.

**Key Takeaways:**

- OpenClaw's default WhatsApp channel uses Baileys, which carries real ban risks
- Pipes.bot bridges the WhatsApp Official Cloud API to your OpenClaw installation via WebSocket
- The connection is outbound-only — your server stays private behind your firewall
- You get two-way messaging, media support, and webhook signature validation out of the box
- Setup takes roughly 5 minutes with no Meta tech provider onboarding required

---

### Table of Contents

- [Why the Default OpenClaw WhatsApp Setup Is Risky](#why-the-default-openclaw-whatsapp-setup-is-risky)
- [What Is Pipes.bot and How Does It Solve This](#what-is-pipesbot-and-how-does-it-solve-this)
- [Pool Numbers vs Bring Your Own Number](#pool-numbers-vs-bring-your-own-number)
- [How the WhatsApp API OpenClaw Integration Works](#how-the-whatsapp-api-openclaw-integration-works)
- [Step-by-Step Setup Guide](#step-by-step-setup-guide)
- [Practical Use Cases](#practical-use-cases)
- [Comparing Baileys vs Official API for OpenClaw](#comparing-baileys-vs-official-api-for-openclaw)
- [Frequently Asked Questions](#frequently-asked-questions)

---

### Why the Default OpenClaw WhatsApp Setup Is Risky

OpenClaw connects to WhatsApp through the [Baileys library](https://github.com/WhiskeySockets/Baileys) — a TypeScript implementation that reverse-engineers the WhatsApp Web multi-device protocol. When you scan the QR code during OpenClaw setup, Baileys emulates a linked device on your personal WhatsApp account.

This approach has three concrete problems.

**Account bans are increasing.** Meta actively detects accounts using unofficial automation. In a [GitHub issue on the Baileys repository](https://github.com/WhiskeySockets/Baileys/issues/1869), multiple developers reported bans on accounts that had been running bots for over 3 years without issues — until they suddenly were banned permanently. The detection is getting stricter, not looser.

**Protocol breakage is unpredictable.** Baileys depends on reverse-engineering a protocol that Meta can change at any time. When WhatsApp updates their servers, Baileys connections can enter reconnect loops. Those abnormal connection patterns are exactly what ban detection systems flag.

**Meta's 2026 policy tightened the rules.** As of January 2026, Meta explicitly blocks general-purpose chatbots on WhatsApp. While business-operation chatbots (customer support, order tracking, FAQs) remain allowed under the Business API, the enforcement net has widened. Using an unofficial library puts your account in a gray area that is increasingly becoming a red zone.

If your OpenClaw agent handles anything important — scheduling, business queries, automation triggers — losing your WhatsApp account means losing that entire workflow overnight.

---

### What Is Pipes.bot and How Does It Solve This

[Pipes.bot](https://www.pipes.bot/) is a managed bridge between WhatsApp's official Cloud API and self-hosted AI agents like OpenClaw. It was created by Tulio Faria specifically to solve the problem described above: giving developers a safe, compliant way to connect WhatsApp to their agents without reverse engineering.

Here is what Pipes.bot does differently:

- **Uses Meta's official WhatsApp Cloud API** — no reverse engineering, no policy violations
- **Connects via outbound WebSocket** — your OpenClaw installation makes an outbound connection to Pipes.bot, meaning you never expose ports or your server's IP address
- **Queues messages** — if your agent goes offline, Pipes.bot queues up to 100 messages and delivers them when it reconnects
- **Supports all media types** — text, images, documents, audio, video — everything the official API supports
- **Validates webhooks with HMAC signatures** — a hash secret ensures no man-in-the-middle tampering with incoming messages

The key architectural difference is that your OpenClaw gateway stays completely private behind your firewall. The WebSocket connection is initiated from your side, so there is nothing to expose publicly.

---

### Pool Numbers vs Bring Your Own Number

<img src="/blog/pool-vs-byon.svg" alt="Pool Numbers vs Bring Your Own Number comparison" width="800" height="400" />

Pipes.bot offers two modes for connecting WhatsApp to OpenClaw. The right choice depends on whether you want to use a dedicated number for your agent or your own business number.

#### Pool Numbers

With Pool Numbers, Pipes.bot provides phone numbers that you activate and link to your personal WhatsApp. The flow is simple: you save a Pipes.bot pool number as a contact, send it a message to activate the pairing, and from that point on, every message you send to that number gets forwarded to your OpenClaw agent via webhook or WebSocket.

**When to use Pool Numbers:**

- You want to connect your personal AI agent without buying a new number
- You need multiple numbers for different agents or automations (e.g., one number for scheduling, another for note-taking)
- You want to test the integration before committing to a business number
- You need separate entry points for different n8n or Make workflows

Each plan on Pipes.bot includes a set number of pool number activations. If you have 3 pool numbers, you can route messages to 3 different agents, automations, or OpenClaw installations — each with its own webhook or WebSocket endpoint.

#### Bring Your Own Number (BYON)

With BYON, you onboard your own phone number (or your customers' numbers) onto the Pipes.bot platform. The number goes through Meta's official embedded signup flow — the same Facebook domain-based process that any WhatsApp Business API provider uses. This means full compliance with WhatsApp's terms of service.

**When to use BYON:**

- You have a dedicated business number for customer communication
- You are building a SaaS product that sends WhatsApp messages on behalf of your users
- You need your customers to onboard their own numbers through a branded flow
- You want to send order confirmations, appointment reminders, or campaign messages from a recognized business number

The BYON mode also supports white-label onboarding. You can customize the onboarding screen with your own brand, logo, and a custom message so your end users recognize the flow as coming from your application — not from Pipes.bot directly.

After a number is onboarded, Pipes.bot sends a webhook notification containing the event type and the number ID. From that point, you use the number ID to send and receive messages through the API.

---

### How the WhatsApp API OpenClaw Integration Works

<img src="/blog/whatsapp-openclaw-flow.svg" alt="Message flow: WhatsApp to OpenClaw via Pipes.bot" width="800" height="400" />

The architecture is straightforward. Here is the data flow when a message arrives:

1. A user sends a WhatsApp message to your Pipes.bot number (pool or BYON)
2. WhatsApp's official Cloud API receives the message and forwards it to Pipes.bot
3. Pipes.bot validates the message and forwards it to your configured endpoint — either a webhook URL or an active WebSocket connection
4. Your OpenClaw installation receives the message over the WebSocket, processes it through your configured LLM (OpenAI, Anthropic, Google, etc.), and generates a response
5. OpenClaw sends the reply back through Pipes.bot's API
6. Pipes.bot delivers the reply to the user via the WhatsApp Cloud API

The entire round trip uses official API endpoints. No QR code scanning, no Baileys, no emulated devices. Your OpenClaw agent communicates through a standard WebSocket connection that it initiates outbound — the same kind of connection your browser makes to any website.

#### What About Media Messages?

Pipes.bot supports every media type that the WhatsApp official API supports. This includes images, audio files, documents, videos, stickers, and location messages. When your OpenClaw agent receives a media message, it arrives with metadata and a URL to fetch the content. Replies can include media attachments as well, enabling rich interactions like sending generated images, PDFs, or voice notes back to the user.

---

### Step-by-Step Setup Guide

Here is how to connect the WhatsApp API to your OpenClaw installation using Pipes.bot.

#### Step 1: Create a Pipes.bot Account and Choose a Plan

Go to [pipes.bot](https://www.pipes.bot/) and sign up. Choose a plan based on how many numbers you need. Each plan includes a specific number of pool number activations and BYON slots.

#### Step 2: Create an App

Inside the Pipes.bot dashboard, create a new App. Each App represents a connection to one application or agent. Give it a name that identifies your OpenClaw instance (e.g., "My OpenClaw Assistant").

#### Step 3: Configure the Delivery Method

In the App settings, choose your delivery method:

- **Webhook** — Pipes.bot will POST incoming messages to a URL you provide. Ideal if your OpenClaw installation is behind a reverse proxy or you want to use n8n/Make as middleware.
- **WebSocket** — Your OpenClaw installation connects outbound to Pipes.bot and receives messages in real time. This is the recommended option because it requires no open ports.

If you choose webhook, paste your endpoint URL and optionally set a hash secret. The hash secret enables HMAC signature validation on every incoming webhook, protecting against message tampering.

If you choose WebSocket, Pipes.bot will provide connection details that you configure in your OpenClaw installation.

#### Step 4: Activate a Pool Number (or Onboard Your Own)

**For Pool Numbers:** Click "Activate" on an available pool number. Pipes.bot will display a WhatsApp number and an activation code. Save the number as a contact on your phone and send the activation code via WhatsApp. Once received, the one-to-one connection between your personal number and the pool number is established.

**For BYON:** Use the embedded signup flow to onboard your business number. This opens Meta's official Facebook domain where you complete the WhatsApp Business verification. After the flow completes, Pipes.bot sends a webhook with the number ID to your configured endpoint.

#### Step 5: Test the Connection

Back in the Pipes.bot dashboard, click "Test" on your configured number. Check your webhook endpoint (or WebSocket listener) to confirm the test message arrives. If you set up a webhook with [webhook.site](https://webhook.site) for testing, you should see the payload immediately.

#### Step 6: Connect to OpenClaw

Configure your OpenClaw installation to use the Pipes.bot WebSocket endpoint instead of the default Baileys channel. The exact configuration depends on your OpenClaw version, but the core change is pointing the WhatsApp channel to the Pipes.bot WebSocket URL with your API key.

Once connected, send a message from WhatsApp to your Pipes.bot number. It should arrive at OpenClaw, get processed by your LLM, and the reply should appear back in your WhatsApp chat — all through the official API.

---

### Practical Use Cases

#### Personal AI Agent via WhatsApp

The most common use case is connecting your personal OpenClaw AI agent to WhatsApp. Instead of opening a terminal or web UI, you message a saved contact on WhatsApp and get responses from your agent — powered by whatever LLM you have configured. This works for quick questions, reminders, note-taking, or anything your OpenClaw skills support.

#### Business Automation with n8n or Make

Connect a Pipes.bot webhook to an n8n or Make workflow. When a customer sends a WhatsApp message, it triggers your automation — which could look up order status, check inventory, create a support ticket, or route the query to the right team member. The reply flows back through Pipes.bot to the customer's WhatsApp.

#### Multi-Agent Routing

Use multiple pool numbers to route different types of queries to different agents. For example, one number for your scheduling agent, another for your research agent, and a third for your e-commerce order bot. Each number connects to a separate webhook or WebSocket endpoint, so each agent only handles its own domain.

#### Customer-Facing SaaS Integration

If you build a SaaS product that needs WhatsApp messaging, use BYON to onboard your customers' numbers. Each customer goes through the branded embedded signup flow, and you receive a webhook with their number ID. From there, your application sends and receives messages on their behalf — order confirmations, appointment reminders, support responses — all through the official API.

---

### Comparing Baileys vs Official API for OpenClaw

<img src="/blog/baileys-vs-pipesbot.svg" alt="Architecture comparison: Baileys vs Official API via Pipes.bot" width="800" height="400" loading="lazy" />

| Factor | Baileys (Default) | Official API via Pipes.bot |
|---|---|---|
| **Compliance** | Violates WhatsApp ToS | Fully compliant with Meta policies |
| **Ban risk** | High and increasing | None — uses official Cloud API |
| **Setup** | Scan QR code | Activate number or onboard via embedded signup |
| **Port exposure** | Requires Baileys WebSocket to WhatsApp servers | Outbound-only WebSocket, no open ports |
| **Media support** | Partial, depends on library version | Full — all types the official API supports |
| **Message reliability** | Can break on protocol updates | Queued delivery with up to 100 messages |
| **Webhook security** | Not applicable | HMAC signature validation with hash secret |
| **Cost** | Free (but risk of losing your account) | Paid plans starting with pool number activations |
| **Multi-number** | One account per instance | Multiple numbers per plan |

The trade-off is clear: Baileys is free but carries real operational risk. Pipes.bot has a cost, but it removes the risk of losing your WhatsApp account and adds features like message queuing, webhook security, and media support that Baileys cannot guarantee.

---

### Frequently Asked Questions

#### Do I need to go through Meta's tech provider onboarding to use the WhatsApp API with OpenClaw?

No. Pipes.bot is already registered as a tech provider with Meta. When you use Pipes.bot, you skip the entire Meta onboarding process. You create an account on Pipes.bot, configure your app, and start sending messages. This is one of the biggest time savings — Meta's tech provider onboarding can take weeks.

#### Can my OpenClaw agent both receive and send messages through the official API?

Yes. The integration supports full two-way communication. Your agent receives incoming messages via webhook or WebSocket, and sends replies back through the Pipes.bot API. The end user sees a normal WhatsApp conversation — they do not know whether the response came from a person or an AI agent.

#### Does the WhatsApp API OpenClaw integration support group chats?

The Pipes.bot integration focuses on one-to-one conversations between your number and individual users. Group chat support depends on the specific WhatsApp Business API tier and Pipes.bot plan features. For most AI agent use cases, one-to-one messaging covers the primary workflow.

#### What happens if my OpenClaw server goes offline?

Pipes.bot queues incoming messages — up to 100 — and delivers them when your agent reconnects. It also sends a WhatsApp notification to let you know messages are pending. This means you do not lose messages during server restarts, deployments, or temporary outages.

#### How is this different from using the WhatsApp Business API directly?

Using the WhatsApp Business API directly requires registering as a tech provider with Meta, managing your own infrastructure for receiving webhooks, handling message queuing, and implementing security measures. Pipes.bot handles all of that for you. You get a clean WebSocket or webhook endpoint that just works, with built-in queuing, signature validation, and a dashboard to manage your numbers.

---

### Conclusion

Connecting the **WhatsApp API to OpenClaw** does not have to mean risking your account with unofficial libraries. Pipes.bot provides a managed bridge that uses Meta's official Cloud API, connects via outbound WebSocket (so you never expose ports), and supports every message type the official API offers.

Whether you use Pool Numbers for quick personal agent setups or BYON for business-grade customer messaging, the integration gives your OpenClaw installation a reliable, compliant WhatsApp channel. The setup takes minutes, not weeks, and you avoid the entire Meta tech provider onboarding process.

If you are running OpenClaw and want a WhatsApp connection you can trust in production, [Pipes.bot](https://www.pipes.bot/) is the path that keeps your account safe and your agent online.

For questions or specific use case discussions, you can reach the Pipes.bot team directly via email — founder Tulio Faria personally responds to all inquiries.


---

# Começando: Conecte Seu Agente de IA ao WhatsApp

Source: blog/pt-br/comecando-com-pipes-bot.mdx

> Aprenda como conectar seu agente de IA auto-hospedado ao WhatsApp usando a ponte oficial da API Cloud do Pipes.bot. Sem Baileys, sem portas expostas, sem risco.

### 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](https://app.pipes.bot))
- 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](https://app.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:**

```bash
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](https://docs.pipes.bot) para referência da API e configuração avançada
- Junte-se à comunidade para dicas e suporte


---

# WhatsApp API OpenClaw: API Oficial

Source: blog/pt-br/whatsapp-api-openclaw.mdx

> Integre a API Oficial do WhatsApp com o OpenClaw usando o Pipes.bot. Sem Baileys, sem portas expostas — uma ponte segura para seu agente de IA.

### Como Usar a API Oficial do WhatsApp com o OpenClaw

Se você tem uma instalação do OpenClaw e quer conectá-la ao WhatsApp sem arriscar sua conta, este guia é para você. O canal padrão de WhatsApp do OpenClaw depende do Baileys — uma biblioteca não oficial que faz engenharia reversa do protocolo do WhatsApp Web. Embora funcione, viola os Termos de Serviço da Meta e pode levar a banimentos permanentes.

Existe um caminho melhor. Usando a **API Oficial do WhatsApp com o OpenClaw** através de um serviço de ponte como o [Pipes.bot](https://www.pipes.bot/), você obtém uma conexão totalmente compatível e confiável que não exige portas abertas nem bibliotecas não oficiais. Este artigo mostra como funciona, por que isso importa e como configurar.

**Principais Pontos:**

- O canal padrão de WhatsApp do OpenClaw usa Baileys, que traz riscos reais de banimento
- O Pipes.bot faz a ponte entre a API Cloud oficial do WhatsApp e sua instalação do OpenClaw via WebSocket
- A conexão é somente de saída — seu servidor permanece privado atrás do seu firewall
- Você obtém mensagens bidirecionais, suporte a mídia e validação de assinatura de webhook inclusos
- A configuração leva cerca de 5 minutos sem necessidade de cadastro como provedor técnico da Meta

---

### Índice

- [Por Que a Configuração Padrão de WhatsApp do OpenClaw É Arriscada](#por-que-a-configuração-padrão-de-whatsapp-do-openclaw-é-arriscada)
- [O Que É o Pipes.bot e Como Ele Resolve Isso](#o-que-é-o-pipesbot-e-como-ele-resolve-isso)
- [Números Pool vs Traga Seu Próprio Número](#números-pool-vs-traga-seu-próprio-número)
- [Como Funciona a Integração WhatsApp API OpenClaw](#como-funciona-a-integração-whatsapp-api-openclaw)
- [Guia de Configuração Passo a Passo](#guia-de-configuração-passo-a-passo)
- [Casos de Uso Práticos](#casos-de-uso-práticos)
- [Comparando Baileys vs API Oficial para OpenClaw](#comparando-baileys-vs-api-oficial-para-openclaw)
- [Perguntas Frequentes](#perguntas-frequentes)

---

### Por Que a Configuração Padrão de WhatsApp do OpenClaw É Arriscada

O OpenClaw se conecta ao WhatsApp através da [biblioteca Baileys](https://github.com/WhiskeySockets/Baileys) — uma implementação em TypeScript que faz engenharia reversa do protocolo multi-dispositivo do WhatsApp Web. Quando você escaneia o QR code durante a configuração do OpenClaw, o Baileys emula um dispositivo vinculado na sua conta pessoal do WhatsApp.

Essa abordagem tem três problemas concretos.

**Os banimentos de conta estão aumentando.** A Meta detecta ativamente contas usando automação não oficial. Em uma [issue no GitHub do repositório do Baileys](https://github.com/WhiskeySockets/Baileys/issues/1869), vários desenvolvedores relataram banimentos em contas que estavam rodando bots por mais de 3 anos sem problemas — até serem banidos permanentemente de repente. A detecção está ficando mais rígida, não mais flexível.

**A quebra de protocolo é imprevisível.** O Baileys depende da engenharia reversa de um protocolo que a Meta pode alterar a qualquer momento. Quando o WhatsApp atualiza seus servidores, as conexões do Baileys podem entrar em loops de reconexão. Esses padrões anormais de conexão são exatamente o que os sistemas de detecção de banimento identificam.

**A política de 2026 da Meta endureceu as regras.** A partir de janeiro de 2026, a Meta bloqueia explicitamente chatbots de propósito geral no WhatsApp. Embora chatbots de operações empresariais (suporte ao cliente, rastreamento de pedidos, FAQs) continuem permitidos sob a API Business, a rede de fiscalização se ampliou. Usar uma biblioteca não oficial coloca sua conta em uma zona cinzenta que está cada vez mais se tornando uma zona vermelha.

Se o seu agente OpenClaw lida com algo importante — agendamentos, consultas empresariais, gatilhos de automação — perder sua conta do WhatsApp significa perder todo esse fluxo de trabalho da noite para o dia.

---

### O Que É o Pipes.bot e Como Ele Resolve Isso

O [Pipes.bot](https://www.pipes.bot/) é uma ponte gerenciada entre a API Cloud oficial do WhatsApp e agentes de IA auto-hospedados como o OpenClaw. Foi criado por Tulio Faria especificamente para resolver o problema descrito acima: dar aos desenvolvedores uma forma segura e compatível de conectar o WhatsApp aos seus agentes sem engenharia reversa.

Veja o que o Pipes.bot faz de diferente:

- **Usa a API Cloud oficial do WhatsApp da Meta** — sem engenharia reversa, sem violações de política
- **Conecta via WebSocket de saída** — sua instalação do OpenClaw faz uma conexão de saída para o Pipes.bot, o que significa que você nunca expõe portas nem o endereço IP do seu servidor
- **Enfileira mensagens** — se seu agente ficar offline, o Pipes.bot enfileira até 100 mensagens e as entrega quando ele reconectar
- **Suporta todos os tipos de mídia** — texto, imagens, documentos, áudio, vídeo — tudo que a API oficial suporta
- **Valida webhooks com assinaturas HMAC** — um hash secret garante que não haja adulteração man-in-the-middle nas mensagens recebidas

A principal diferença arquitetural é que seu gateway OpenClaw permanece completamente privado atrás do seu firewall. A conexão WebSocket é iniciada do seu lado, então não há nada a expor publicamente.

---

### Números Pool vs Traga Seu Próprio Número

<img src="/blog/pool-vs-byon.svg" alt="Comparação Números Pool vs Traga Seu Próprio Número" width="800" height="400" />

O Pipes.bot oferece dois modos para conectar o WhatsApp ao OpenClaw. A escolha certa depende de você querer usar um número dedicado para seu agente ou seu próprio número comercial.

#### Números Pool

Com Números Pool, o Pipes.bot fornece números de telefone que você ativa e vincula ao seu WhatsApp pessoal. O fluxo é simples: você salva um número pool do Pipes.bot como contato, envia uma mensagem para ativar o pareamento, e a partir desse ponto, toda mensagem que você enviar para esse número é encaminhada ao seu agente OpenClaw via webhook ou WebSocket.

**Quando usar Números Pool:**

- Você quer conectar seu agente pessoal de IA sem comprar um novo número
- Você precisa de múltiplos números para diferentes agentes ou automações (ex: um número para agendamentos, outro para anotações)
- Você quer testar a integração antes de se comprometer com um número comercial
- Você precisa de pontos de entrada separados para diferentes fluxos do n8n ou Make

Cada plano no Pipes.bot inclui um número definido de ativações de números pool. Se você tem 3 números pool, pode rotear mensagens para 3 agentes, automações ou instalações do OpenClaw diferentes — cada um com seu próprio endpoint de webhook ou WebSocket.

#### Traga Seu Próprio Número (BYON)

Com BYON, você cadastra seu próprio número de telefone (ou os números dos seus clientes) na plataforma Pipes.bot. O número passa pelo fluxo de cadastro incorporado oficial da Meta — o mesmo processo baseado no domínio do Facebook que qualquer provedor de API WhatsApp Business usa. Isso significa total conformidade com os termos de serviço do WhatsApp.

**Quando usar BYON:**

- Você tem um número comercial dedicado para comunicação com clientes
- Você está construindo um produto SaaS que envia mensagens pelo WhatsApp em nome dos seus usuários
- Você precisa que seus clientes cadastrem seus próprios números através de um fluxo personalizado
- Você quer enviar confirmações de pedido, lembretes de agendamento ou mensagens de campanha de um número comercial reconhecido

O modo BYON também suporta cadastro white-label. Você pode personalizar a tela de cadastro com sua própria marca, logo e uma mensagem personalizada para que seus usuários finais reconheçam o fluxo como vindo da sua aplicação — não diretamente do Pipes.bot.

Após o cadastro de um número, o Pipes.bot envia uma notificação via webhook contendo o tipo de evento e o ID do número. A partir daí, você usa o ID do número para enviar e receber mensagens pela API.

---

### Como Funciona a Integração WhatsApp API OpenClaw

<img src="/blog/whatsapp-openclaw-flow.svg" alt="Fluxo de mensagens: WhatsApp para OpenClaw via Pipes.bot" width="800" height="400" />

A arquitetura é direta. Aqui está o fluxo de dados quando uma mensagem chega:

1. Um usuário envia uma mensagem pelo WhatsApp para o seu número Pipes.bot (pool ou BYON)
2. A API Cloud oficial do WhatsApp recebe a mensagem e a encaminha para o Pipes.bot
3. O Pipes.bot valida a mensagem e a encaminha para o seu endpoint configurado — seja uma URL de webhook ou uma conexão WebSocket ativa
4. Sua instalação do OpenClaw recebe a mensagem pelo WebSocket, a processa através do seu LLM configurado (OpenAI, Anthropic, Google, etc.) e gera uma resposta
5. O OpenClaw envia a resposta de volta pela API do Pipes.bot
6. O Pipes.bot entrega a resposta ao usuário pela API Cloud do WhatsApp

Todo o ciclo usa endpoints oficiais da API. Sem escaneamento de QR code, sem Baileys, sem dispositivos emulados. Seu agente OpenClaw se comunica através de uma conexão WebSocket padrão que ele inicia de saída — o mesmo tipo de conexão que seu navegador faz com qualquer site.

#### E as Mensagens de Mídia?

O Pipes.bot suporta todos os tipos de mídia que a API oficial do WhatsApp suporta. Isso inclui imagens, arquivos de áudio, documentos, vídeos, stickers e mensagens de localização. Quando seu agente OpenClaw recebe uma mensagem de mídia, ela chega com metadados e uma URL para buscar o conteúdo. As respostas também podem incluir anexos de mídia, permitindo interações ricas como enviar imagens geradas, PDFs ou notas de voz de volta ao usuário.

---

### Guia de Configuração Passo a Passo

Veja como conectar a API do WhatsApp à sua instalação do OpenClaw usando o Pipes.bot.

#### Passo 1: Crie uma Conta no Pipes.bot e Escolha um Plano

Acesse [pipes.bot](https://www.pipes.bot/) e cadastre-se. Escolha um plano com base em quantos números você precisa. Cada plano inclui um número específico de ativações de números pool e slots BYON.

#### Passo 2: Crie um App

Dentro do painel do Pipes.bot, crie um novo App. Cada App representa uma conexão com uma aplicação ou agente. Dê um nome que identifique sua instância do OpenClaw (ex: "Meu Assistente OpenClaw").

#### Passo 3: Configure o Método de Entrega

Nas configurações do App, escolha seu método de entrega:

- **Webhook** — O Pipes.bot fará POST das mensagens recebidas para uma URL que você fornecer. Ideal se sua instalação do OpenClaw está atrás de um proxy reverso ou se você quer usar n8n/Make como middleware.
- **WebSocket** — Sua instalação do OpenClaw conecta de saída ao Pipes.bot e recebe mensagens em tempo real. Esta é a opção recomendada porque não exige portas abertas.

Se você escolher webhook, cole a URL do seu endpoint e opcionalmente defina um hash secret. O hash secret habilita validação de assinatura HMAC em cada webhook recebido, protegendo contra adulteração de mensagens.

Se você escolher WebSocket, o Pipes.bot fornecerá os detalhes de conexão que você configura na sua instalação do OpenClaw.

#### Passo 4: Ative um Número Pool (ou Cadastre o Seu Próprio)

**Para Números Pool:** Clique em "Ativar" em um número pool disponível. O Pipes.bot exibirá um número de WhatsApp e um código de ativação. Salve o número como contato no seu celular e envie o código de ativação via WhatsApp. Uma vez recebido, a conexão um-para-um entre seu número pessoal e o número pool está estabelecida.

**Para BYON:** Use o fluxo de cadastro incorporado para cadastrar seu número comercial. Isso abre o domínio oficial do Facebook da Meta, onde você completa a verificação do WhatsApp Business. Após a conclusão do fluxo, o Pipes.bot envia um webhook com o ID do número para o seu endpoint configurado.

#### Passo 5: Teste a Conexão

De volta ao painel do Pipes.bot, clique em "Testar" no seu número configurado. Verifique seu endpoint de webhook (ou listener WebSocket) para confirmar que a mensagem de teste chegou. Se você configurou um webhook com [webhook.site](https://webhook.site) para testes, você deverá ver o payload imediatamente.

#### Passo 6: Conecte ao OpenClaw

Configure sua instalação do OpenClaw para usar o endpoint WebSocket do Pipes.bot em vez do canal Baileys padrão. A configuração exata depende da sua versão do OpenClaw, mas a mudança principal é apontar o canal do WhatsApp para a URL WebSocket do Pipes.bot com sua chave de API.

Uma vez conectado, envie uma mensagem pelo WhatsApp para o seu número Pipes.bot. Ela deverá chegar ao OpenClaw, ser processada pelo seu LLM, e a resposta deverá aparecer de volta no seu chat do WhatsApp — tudo pela API oficial.

---

### Casos de Uso Práticos

#### Agente Pessoal de IA via WhatsApp

O caso de uso mais comum é conectar seu agente pessoal de IA do OpenClaw ao WhatsApp. Em vez de abrir um terminal ou interface web, você envia uma mensagem para um contato salvo no WhatsApp e recebe respostas do seu agente — alimentado por qualquer LLM que você tenha configurado. Isso funciona para perguntas rápidas, lembretes, anotações ou qualquer coisa que as habilidades do seu OpenClaw suportem.

#### Automação Empresarial com n8n ou Make

Conecte um webhook do Pipes.bot a um fluxo do n8n ou Make. Quando um cliente enviar uma mensagem pelo WhatsApp, ela aciona sua automação — que pode consultar status de pedido, verificar estoque, criar um ticket de suporte ou direcionar a consulta para o membro da equipe certo. A resposta retorna através do Pipes.bot para o WhatsApp do cliente.

#### Roteamento Multi-Agente

Use múltiplos números pool para rotear diferentes tipos de consultas para diferentes agentes. Por exemplo, um número para seu agente de agendamento, outro para seu agente de pesquisa e um terceiro para seu bot de pedidos de e-commerce. Cada número conecta a um endpoint separado de webhook ou WebSocket, então cada agente lida apenas com seu próprio domínio.

#### Integração SaaS Voltada ao Cliente

Se você constrói um produto SaaS que precisa de mensagens pelo WhatsApp, use BYON para cadastrar os números dos seus clientes. Cada cliente passa pelo fluxo de cadastro personalizado, e você recebe um webhook com o ID do número deles. A partir daí, sua aplicação envia e recebe mensagens em nome deles — confirmações de pedido, lembretes de agendamento, respostas de suporte — tudo pela API oficial.

---

### Comparando Baileys vs API Oficial para OpenClaw

<img src="/blog/baileys-vs-pipesbot.svg" alt="Comparação de arquitetura: Baileys vs API Oficial via Pipes.bot" width="800" height="400" loading="lazy" />

| Fator | Baileys (Padrão) | API Oficial via Pipes.bot |
|---|---|---|
| **Conformidade** | Viola os ToS do WhatsApp | Totalmente compatível com as políticas da Meta |
| **Risco de banimento** | Alto e crescente | Nenhum — usa a API Cloud oficial |
| **Configuração** | Escanear QR code | Ativar número ou cadastrar via signup incorporado |
| **Exposição de portas** | Requer WebSocket do Baileys para servidores do WhatsApp | WebSocket somente de saída, sem portas abertas |
| **Suporte a mídia** | Parcial, depende da versão da biblioteca | Total — todos os tipos que a API oficial suporta |
| **Confiabilidade de mensagens** | Pode quebrar em atualizações de protocolo | Entrega em fila com até 100 mensagens |
| **Segurança de webhook** | Não aplicável | Validação de assinatura HMAC com hash secret |
| **Custo** | Grátis (mas risco de perder sua conta) | Planos pagos começando com ativações de números pool |
| **Multi-número** | Uma conta por instância | Múltiplos números por plano |

A troca é clara: o Baileys é gratuito, mas carrega risco operacional real. O Pipes.bot tem um custo, mas remove o risco de perder sua conta do WhatsApp e adiciona recursos como enfileiramento de mensagens, segurança de webhook e suporte a mídia que o Baileys não pode garantir.

---

### Perguntas Frequentes

#### Preciso passar pelo cadastro de provedor técnico da Meta para usar a API do WhatsApp com o OpenClaw?

Não. O Pipes.bot já é registrado como provedor técnico junto à Meta. Quando você usa o Pipes.bot, pula todo o processo de cadastro da Meta. Você cria uma conta no Pipes.bot, configura seu app e começa a enviar mensagens. Essa é uma das maiores economias de tempo — o cadastro de provedor técnico da Meta pode levar semanas.

#### Meu agente OpenClaw pode tanto receber quanto enviar mensagens pela API oficial?

Sim. A integração suporta comunicação bidirecional completa. Seu agente recebe mensagens de entrada via webhook ou WebSocket e envia respostas de volta pela API do Pipes.bot. O usuário final vê uma conversa normal do WhatsApp — ele não sabe se a resposta veio de uma pessoa ou de um agente de IA.

#### A integração WhatsApp API OpenClaw suporta chats em grupo?

A integração do Pipes.bot foca em conversas um-para-um entre seu número e usuários individuais. O suporte a chat em grupo depende do nível específico da API WhatsApp Business e dos recursos do plano Pipes.bot. Para a maioria dos casos de uso de agentes de IA, mensagens um-para-um cobrem o fluxo principal de trabalho.

#### O que acontece se meu servidor OpenClaw ficar offline?

O Pipes.bot enfileira mensagens recebidas — até 100 — e as entrega quando seu agente reconectar. Ele também envia uma notificação pelo WhatsApp para avisar que há mensagens pendentes. Isso significa que você não perde mensagens durante reinicializações de servidor, deploys ou interrupções temporárias.

#### Como isso é diferente de usar a API WhatsApp Business diretamente?

Usar a API WhatsApp Business diretamente requer se registrar como provedor técnico junto à Meta, gerenciar sua própria infraestrutura para receber webhooks, lidar com enfileiramento de mensagens e implementar medidas de segurança. O Pipes.bot cuida de tudo isso para você. Você obtém um endpoint limpo de WebSocket ou webhook que simplesmente funciona, com enfileiramento embutido, validação de assinatura e um painel para gerenciar seus números.

---

### Conclusão

Conectar a **API do WhatsApp ao OpenClaw** não precisa significar arriscar sua conta com bibliotecas não oficiais. O Pipes.bot fornece uma ponte gerenciada que usa a API Cloud oficial da Meta, conecta via WebSocket de saída (então você nunca expõe portas) e suporta todos os tipos de mensagem que a API oficial oferece.

Seja usando Números Pool para configurações rápidas de agentes pessoais ou BYON para mensagens de nível empresarial com clientes, a integração dá à sua instalação do OpenClaw um canal de WhatsApp confiável e compatível. A configuração leva minutos, não semanas, e você evita todo o processo de cadastro de provedor técnico da Meta.

Se você está rodando o OpenClaw e quer uma conexão WhatsApp em que pode confiar em produção, o [Pipes.bot](https://www.pipes.bot/) é o caminho que mantém sua conta segura e seu agente online.

Para dúvidas ou discussões sobre casos de uso específicos, você pode entrar em contato com a equipe do Pipes.bot diretamente por e-mail — o fundador Tulio Faria responde pessoalmente a todas as consultas.


---

## About This Document

This concatenated documentation file is generated automatically by aeo.js
to make it easier for AI systems to understand the complete context of this project.

For a structured index, see: https://www.pipes.bot/llms.txt
For individual files, see: https://www.pipes.bot/docs.json

Generated by aeo.js - https://aeojs.org