# API de WhatsApp para software house

> URL: https://wame.api.br/api-whatsapp-para-software-house
> Software house: pare de refazer a integração de WhatsApp a cada projeto. Um SDK, três canais da Meta e mensalidade em cima do cliente.

## Para quem entrega software sob medida

A WAME é a camada de mensageria da sua software house. Um SDK, três canais oficiais da Meta e um webhook — o mesmo código em todo projeto que você entrega. E uma mensalidade sua em cima de cada cliente.

Você escreve a integração uma vez. Ela serve todo projeto que sair daqui pra frente.

## O que você refaz em todo projeto

O trabalho nunca foi mandar mensagem. É manter viva uma integração que você entregou e não cobra mais por ela.

**Refazendo em cada projeto:**

- Criar app no Meta for Developers a cada cliente
- Verificação de negócio no CNPJ do cliente — e a espera
- Um parser de webhook por canal, três no total
- Suporte não faturado quando a Meta muda a API
- Estimativa de 40h que vira 200h
- Projeto entregue, receita encerrada

**Com a WAME por baixo:**

- Nenhum app na Meta — a infraestrutura é nossa
- Nada no nome do cliente, nada de espera
- Um parser só, para os três canais
- Mudança de API é problema nosso, não seu
- Integração previsível, do primeiro projeto ao décimo
- Projeto entregue, mensalidade começando

Somos Meta Business Partner. A infraestrutura oficial já está pronta e mantida do nosso lado — a sua equipe consome e entrega.

## O que muda na sua próxima proposta

- **1 SDK** — Escreve uma vez, reusa em todo projeto: O módulo que você fizer para o cliente de hoje entra no próximo sem alteração. A integração deixa de ser item de escopo e vira biblioteca interna da casa.
- **1 webhook** — Um handler serve pros três canais: WhatsApp, Instagram e Messenger chegam no mesmo envelope. Só um campo diz o canal. O cliente que amanhã pedir Instagram não vira projeto novo.
- **0 apps na Meta** — A burocracia não é sua nem do cliente: Sem app aprovado, sem verificação de negócio no CNPJ do cliente, sem virar Tech Provider. Some a etapa que trava a entrega por semanas e ninguém consegue estimar.

## Três canais. O mesmo webhook

Você escreve o handler uma vez. Ele serve pros três — e pro próximo cliente também.

- WhatsApp, Instagram e Messenger no mesmo formato de payload
- Oficial e não oficial com o mesmo SDK e o mesmo webhook
- A escolha é por instância — migre sem reescrever nada
- SDK em PHP e JavaScript

- **WhatsApp** — Cloud API oficial
- **Instagram** — Direct API oficial
- **Messenger** — Send API oficial

O evento que chega — só o campo provider muda:

```json
{
  "object": "wame",
  // whatsapp | instagram | messenger
  "provider": "instagram",
  "entry": [{
    "id": "<instance-id>",
    "changes": [{
      "field": "messages",
      "value": {
        "messages": [{
          "from": "5511999990000",
          "type": "text",
          "text": { "body": "Hi! 👋" }
        }]
      }
    }]
  }]
}
```

O código do seu lado — um módulo para os três:

```js
// One module. Every project you deliver reuses it.
export function wameWebhook(req, res) {
  const { provider, entry } = req.body;
  const msg = entry[0].changes[0].value.messages?.[0];
  if (!msg) return res.sendStatus(200);

  onIncomingMessage({
    channel: provider,   // whatsapp | instagram | messenger
    from: msg.from,
    text: msg.text?.body,
  });

  res.sendStatus(200);
}
```

## Como encaixa no sistema que você entrega

O cliente final nunca vê a WAME. Ele vê o WhatsApp funcionando dentro do sistema que você fez.

1. **Você cria a instância pela API** — Criar, ativar, desativar e excluir são chamadas suas. O provisionamento acontece dentro do onboarding do seu sistema — ninguém abre painel nosso.
2. **O cliente conecta a conta dele** — Login seguro pela própria Meta no oficial, ou QR Code no não oficial. Ele escolhe WhatsApp, Instagram e/ou Messenger.
3. **Tudo cai no seu webhook** — Os três canais no mesmo envelope, na URL que você configurou. O WhatsApp vira uma feature do seu sistema — não um projeto à parte.

Gerenciamento 100% via API. O ciclo de vida do cliente fica no seu billing, não no nosso painel — então trial, corte e reativação são decisão sua.

## A escolha é por cliente, não por fornecedor

Você não precisa de dois fornecedores para atender dois portes de cliente. É a mesma plataforma, o mesmo SDK e o mesmo webhook.

### API oficial (Meta)

Para o cliente que precisa de contrato, escala e o número no nome dele.

- Sem risco de bloqueio do número
- Coexistência: o cliente segue atendendo pelo celular
- Instagram e Messenger na mesma instância

### API não oficial (QR Code)

Para o cliente pequeno, que quer começar hoje e sem custo por conversa.

- Conecta lendo um QR Code, sem aprovação
- Sem cobrança da Meta por conversa
- Botões, listas, enquete, grupos e Pix na mensagem

Migrar um cliente de um para o outro não reescreve o seu código: muda a instância, e o handler continua o mesmo.

## De escopo fechado a receita recorrente

Preço por volume, fatura mensal consolidada via PIX e toda instância já com permissões Enterprise. Mínimo de 20 instâncias, sem fidelidade.

| instâncias | Valor por instância/mês |
|---|---|
| 20–99 | R$ 28,00 |
| 100–299 | R$ 24,00 |
| 300–799 | R$ 20,00 |
| 800+ | sob consulta |

Cálculo apenas do custo da plataforma. Nas instâncias oficiais, as conversas são cobradas pela Meta à parte, direto na conta do seu cliente.

## Antes de você perguntar

**E se o cliente quiser levar o número dele embora?**
O número é do cliente, e isso não muda. Na API oficial a conta é criada no Business Manager dele, então ele pode sair a qualquer momento — inclusive de você. É desconfortável dizer isso numa página de vendas, mas é o que separa parceiro de refém: quem fica, fica porque quer.

**Posso usar no CNPJ do cliente ou tem que ser no meu?**
Os dois funcionam. Na API oficial, a conta do WhatsApp fica no Business Manager do cliente e a instância fica na sua conta de parceiro — ele é dono do número, você é dono da operação. Se preferir concentrar tudo em você, também dá.

**Quem atende o cliente final quando dá problema?**
Você, porque é a sua marca na frente. Mas quem atende você é o time que faz a plataforma, em português e direto — não um nível 1 lendo roteiro. Falha de canal, comportamento estranho de webhook e dúvida de payload chegam em quem mexe no código.

**Dá para o cliente não saber que a WAME existe?**
Dá. Todo o gerenciamento é via API, dentro do seu onboarding e do seu billing. O cliente vê o WhatsApp funcionando no sistema que você entregou; não há painel nosso na frente dele.

**Só tenho 3 clientes que pedem WhatsApp hoje. Vale?**
Para o programa de parceiros, ainda não — ele começa em 20 instâncias. Mas você pode usar a plataforma normalmente por cliente e entrar no programa quando o volume chegar. O código não muda: o que muda é a fatura.

**E se eu já tenho uma integração não oficial rodando?**
Não precisa jogar fora. Oficial e não oficial usam o mesmo SDK e o mesmo formato de webhook, e a escolha é por instância. Você sobe cliente novo no oficial e migra os antigos no seu ritmo, sem reescrever o handler.

## Entregue WhatsApp no projeto do cliente sem virar uma empresa de integração

Um SDK, três canais, um webhook — e uma linha de receita que não termina junto com o projeto.

Desde 2017 no mercado de API de mensagens · +50 mil instâncias criadas · 99,9% de uptime · Meta Business Partner oficial

Tem produto próprio? Veja a página de CRM e SaaS: https://wame.api.br/whatsapp-api-para-crm-e-saas · Sobre a API oficial: https://wame.api.br/oficial · Todos os eventos: https://wame.api.br/docs/webhooks · Referência da API: https://wame.api.br/docs/api · Uptime público: https://wame.api.br/status