# WAME API na prática: seu primeiro envio no WhatsApp, Instagram e Messenger em 10 minutos

> Quickstart da WAME API: crie a instância, conecte e faça o primeiro envio no WhatsApp, Instagram e Messenger com SDK Node, PHP ou cURL em 10 minutos.

**Em cerca de 10 minutos você cria uma instância, conecta um canal e faz o primeiro envio no WhatsApp, no Instagram Direct e no Messenger — com o mesmo SDK e o mesmo método.** Este é um guia direto de getting-started: cada passo tem código pronto em Node, PHP e cURL, e no fim você já terá disparado sua primeira mensagem nos três canais.

Se você está avaliando a WAME ou acabou de criar sua conta, siga na ordem. Não precisa criar app na Meta, montar webhook por canal nem aprender três integrações diferentes.

## O que é a WAME

A WAME é uma plataforma **Meta Business Partner** (parceira oficial desde 2017, com mais de 50 mil instâncias ativas e 99,9% de uptime) que reúne, no mesmo lugar, a **API oficial (Cloud API da Meta)** e a **não oficial (conexão por QR Code, estilo WhatsApp Web)**. Você escolhe a abordagem que faz sentido para o seu caso — as duas convivem na mesma plataforma.

O ponto central para este guia: **WhatsApp, Instagram Direct e Messenger vivem na mesma instância** e falam o mesmo padrão (o envelope da Meta). Para trocar de canal, você muda um único campo: `provider`. Um padrão, três canais.

## Passo 1 — Criar a instância no portal

Acesse o [portal da WAME](https://portal.api-wa.me/) e crie uma instância. Ao criá-la, você recebe dois valores que vai usar em todo o código:

- **`server`** — a base da API (por exemplo, `https://us.api-wa.me`).
- **`key`** — a chave da sua instância, que autentica as requisições.

Guarde a `key` como um segredo: ela dá acesso ao envio pela sua instância. Nos exemplos abaixo ela aparece como `YOUR_KEY`.

## Passo 2 — Conectar o canal

Com a instância criada, o próximo passo é conectá-la a um número/conta. Aqui entram as duas abordagens da WAME:

- **Não oficial (QR Code):** você gera a conexão e escaneia o QR Code com o app do WhatsApp, igual ao WhatsApp Web. Basta um `POST` na instância:

```bash
curl -X POST "https://us.api-wa.me/YOUR_KEY/instance"
```

A resposta traz o QR Code para você escanear. Em segundos o número fica conectado e pronto para enviar.

- **Oficial (Embedded Signup):** para a Cloud API da Meta, a conexão é feita pelo fluxo oficial **Embedded Signup**, direto no portal. É o mesmo OAuth seguro da Meta, com token criptografado — e a WAME mantém o app aprovado e o webhook central, então você **não** vira Tech Provider nem cria app no Meta for Developers.

Para Instagram Direct e Messenger, a conexão é a oficial via Embedded Signup. Depois de conectar, os três canais ficam disponíveis na mesma instância.

## Passo 3 — Instalar o SDK (ou usar cURL)

Há SDK oficial para Node/TypeScript e para PHP. Se sua linguagem for outra, use a REST direto — todo o exemplo em cURL vale para qualquer stack.

Node/TypeScript:

```bash
npm i @raphaelvserafim/client-api-whatsapp
```

PHP:

```bash
composer require raphaelvserafim/client-php-api-wa-me
```

A referência completa está em [/docs/sdk/ts](/docs/sdk/ts) e [/docs/sdk/php](/docs/sdk/php).

## Passo 4 — Primeiro envio de texto (WhatsApp)

Agora o momento que importa: disparar a primeira mensagem. Comece pelo WhatsApp, que é o `provider` padrão.

Com Node/TypeScript:

```ts
import { Wame, TypeMessage } from '@raphaelvserafim/client-api-whatsapp';

const wa = new Wame({ server: "https://us.api-wa.me", key: "YOUR_KEY" });

await wa.message.send({
  type: TypeMessage.TEXT,
  body: { to: "5511999999999", text: "Meu primeiro envio!" }
});
```

A classe é `Wame` (`WhatsApp` é um alias depreciado). Há também atalhos mais curtos, como `wa.message.sendText(to, text)`.

Com PHP:

```php
use Api\Wame\Wame;

$wa = new Wame(['server' => 'https://us.api-wa.me', 'key' => 'YOUR_KEY']);

$wa->message->sendText('5511999999999', 'Meu primeiro envio!');
```

E com cURL, se você prefere HTTP puro:

```bash
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/text" \
  -H "Content-Type: application/json" \
  -d '{"to":"5511999999999","text":"Meu primeiro envio!","provider":"whatsapp"}'
```

Repare no padrão: a `key` vai no path e o destinatário no WhatsApp é o telefone com DDI e DDD. Se a mensagem chegou no seu celular, o quickstart já valeu — o resto é variação.

## Passo 5 — Enviar no Instagram e no Messenger

Aqui está a parte que economiza tempo: **é o mesmo método**. Você só troca o `provider` para `instagram` ou `messenger` e ajusta o destinatário (no Instagram é o `IG_USER_ID`; no Messenger, o `PSID`).

Com Node/TypeScript:

```ts
await wa.message.send({
  type: TypeMessage.TEXT,
  body: { to: "IG_USER_ID", text: "Oi no Instagram", provider: "instagram" }
});

await wa.message.send({
  type: TypeMessage.TEXT,
  body: { to: "PSID", text: "Oi no Messenger", provider: "messenger" }
});
```

Com PHP, usando o enum `Provider`:

```php
use Api\Wame\Provider;

$wa->message->sendText('IG_USER_ID', 'Oi no Instagram', Provider::INSTAGRAM);
$wa->message->sendText('PSID', 'Oi no Messenger', Provider::MESSENGER);
```

Com cURL, é o mesmo endpoint com o `provider` no corpo:

```bash
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/text" \
  -H "Content-Type: application/json" \
  -d '{"to":"IG_USER_ID","text":"Oi no Instagram","provider":"instagram"}'
```

Nada de endpoints diferentes ou SDKs separados por canal. Um campo decide para onde a mensagem vai.

## Enviar mídia rápido (imagem)

Texto é só o começo. Para enviar uma imagem, muda o tipo e o corpo.

Com Node/TypeScript:

```ts
await wa.message.send({
  type: TypeMessage.IMAGE,
  body: { to: "5511999999999", image: { link: "https://exemplo.com/foto.jpg", caption: "Olha isso" } }
});
```

Com PHP, o atalho resolve em uma linha:

```php
$wa->message->sendImage('5511999999999', 'https://exemplo.com/foto.jpg', 'Olha isso');
```

O mesmo vale para Instagram e Messenger: acrescente o `provider` e o destinatário do canal. Os tipos de mídia (`image`, `video`, `audio`, `document`) seguem o mesmo contrato.

## Receber respostas (webhook)

Enviar é metade do fluxo; para atender de verdade, você precisa receber. Isso é feito configurando um webhook na instância: os três canais chegam no **mesmo envelope no formato Meta**, e o campo `provider` no topo indica de qual canal veio a mensagem — então um único handler resolve WhatsApp, Instagram e Messenger. Os detalhes do payload, verify token e assinatura estão no post [Webhook padrão Meta para WhatsApp, Instagram e Messenger](/blog/webhook-whatsapp-instagram-messenger-padrao-meta).

## Por que WAME

Além da rapidez para começar, vale entender o que sustenta essa simplicidade:

- **Sem criar app na Meta.** A WAME mantém o app aprovado, o webhook central e a renovação de token. Você não vira Tech Provider.
- **Oficial e não oficial na mesma plataforma.** Cloud API via Embedded Signup ou conexão por QR Code — sua escolha, sem trocar de arquitetura.
- **Três canais, um padrão.** WhatsApp, Instagram Direct e Messenger na mesma instância; o `provider` é a única ramificação do seu código.
- **SDKs oficiais e REST.** Node/TypeScript e PHP prontos, além da API REST para qualquer linguagem.
- **Preço acessível e suporte de verdade.** A partir de R$28,99/mês, com suporte humano 24/7 em português e 99,9% de uptime.

Para uma visão mais ampla das vantagens, veja também a [documentação da WAME](/docs).

## Próximos passos

Você já fez o primeiro envio nos três canais. A partir daqui:

- **Automatize sem código** conectando a WAME ao seu fluxo — dá para montar um [bot no WhatsApp, Instagram e Messenger com n8n](/n8n-bot-whatsapp-instagram-messenger).
- **Aprofunde os SDKs** em [/docs/sdk/ts](/docs/sdk/ts) e [/docs/sdk/php](/docs/sdk/php).
- **Configure o recebimento** seguindo o guia de [webhook padrão Meta](/blog/webhook-whatsapp-instagram-messenger-padrao-meta).

Crie sua instância agora no [portal da WAME](https://portal.api-wa.me/), conecte um canal e faça o primeiro envio hoje. Dez minutos, três canais, um padrão.

## Perguntas frequentes

### Quanto tempo leva para fazer o primeiro envio na WAME?

Cerca de 10 minutos. Você cria a instância no portal, conecta o canal (QR Code para a versão não oficial ou Embedded Signup para a oficial), instala o SDK ou usa cURL e dispara a primeira mensagem de texto. Não é preciso criar app na Meta.

### Preciso de dois SDKs para WhatsApp, Instagram e Messenger?

Não. É o mesmo SDK e o mesmo método de envio nos três canais. Você só muda o campo provider: whatsapp (padrão), instagram ou messenger. Há SDK oficial para Node/TypeScript e para PHP, além da REST para qualquer linguagem.

### Consigo usar a WAME sem programar em Node ou PHP?

Sim. Todo o envio funciona por REST, então qualquer linguagem que faça uma requisição HTTP serve. O exemplo em cURL mostra o endpoint completo, e você replica isso em Python, Go, Java ou no que preferir.

### Qual a diferença entre a conexão oficial e a não oficial?

A oficial usa a Cloud API da Meta via Embedded Signup, com token e webhook mantidos pela WAME. A não oficial conecta por QR Code, como o WhatsApp Web. As duas ficam na mesma plataforma e usam o mesmo padrão de envio.

### Como recebo as respostas das mensagens?

Configurando um webhook na instância. Os três canais chegam no mesmo envelope no formato Meta, e o campo provider indica de qual canal veio a mensagem, então um único handler resolve tudo.