> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.muchau.com.br/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.muchau.com.br/_mcp/server.

# Introdução

> O que é o Muchaw DEV e como funciona?

## O que é o Muchaw DEV?

O Muchaw DEV é uma plataforma de infraestrutura para desenvolvedores que abstrai a complexidade da [API Cloud do WhatsApp Business](https://developers.facebook.com/docs/whatsapp/cloud-api). Você recebe uma chave de API e pode começar a enviar e receber mensagens pelo WhatsApp em minutos — sem criar um Business Portfolio da Meta, configurar um App da Meta ou gerenciar tokens de acesso.

## O que NÃO é

* Não é um criador de chatbots (como BotConversa ou ManyChat)
* Não é uma plataforma de suporte ao cliente (como Zendesk ou Zap Responder)
* Não é uma API não-oficial do WhatsApp (usa exclusivamente a API Cloud oficial da Meta)
* Não é um produto front-end — é infraestrutura para desenvolvedores

## Como funciona

```
Desenvolvedor → Chave de API → API do Muchaw DEV → API Cloud da Meta
                                      ↕
                                PostgreSQL + Redis
                                      ↕
Webhook da Meta → Muchaw DEV → Fila → Despachante de Webhook → URL do seu servidor
```

1. **Você** se cadastra e obtém uma chave de API.
2. **Seus usuários finais** conectam seus números do WhatsApp via Embedded Signup ou um Link de Cadastro (um fluxo white-label alimentado pelo App da Meta do Muchaw DEV).
3. **O Muchaw DEV** registra o número automaticamente, configura o 2FA e dispara um webhook `number.activated` para o seu servidor.
4. **Você** envia e recebe mensagens via REST API.
5. **Mensagens recebidas** da Meta são roteadas do endpoint de webhook do Muchaw DEV para as suas URLs de webhook configuradas.

## Oficial e seguro

O Muchaw DEV usa exclusivamente a API Cloud oficial da Meta. Não há nenhum risco de banimento de números por uso de protocolos não-oficiais.

## Superfície completa da API

A plataforma expõe os seguintes módulos via REST API na URL base `https://dev.muchau.com.br/api`:

| Módulo            | Prefixo                | Auth                                                   | Descrição                                                    |
| ----------------- | ---------------------- | ------------------------------------------------------ | ------------------------------------------------------------ |
| Auth              | `/api/auth`            | Sessão Clerk                                           | Informações de conta, CRUD de chave de API                   |
| Números           | `/api/numbers`         | Chave de API ou Clerk                                  | Listar, obter, desconectar números do WhatsApp               |
| Mensagens         | `/api/messages`        | Chave de API ou Clerk                                  | Enviar mensagens, listar/obter logs de mensagens             |
| Webhooks          | `/api/webhooks`        | Chave de API ou Clerk                                  | CRUD de webhooks, testar, rotacionar secret                  |
| Embedded Signup   | `/api/embedded-signup` | Chave de API ou Clerk                                  | Iniciar/completar fluxo de Embedded Signup do Facebook       |
| Links de Cadastro | `/api/signup-links`    | Chave de API ou Clerk (autenticado) / nenhum (público) | Criar/gerenciar links de cadastro compartilháveis            |
| Webhook da Meta   | `/api/meta`            | Assinatura HMAC                                        | Receptor interno de eventos da Meta (não chamar diretamente) |

Todos os endpoints retornam JSON. Respostas de erro seguem o formato `{ "error": { "code", "message", "status" } }`.