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 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:

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:

npm i @raphaelvserafim/client-api-whatsapp

PHP:

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

A referência completa está em /docs/sdk/ts e /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:

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:

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:

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:

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:

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:

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:

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:

$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.

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.

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.
• Aprofunde os SDKs em /docs/sdk/ts e /docs/sdk/php.
• Configure o recebimento seguindo o guia de webhook padrão Meta.

Crie sua instância agora no portal da WAME, 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.

Continue lendo

API de Instagram e Messenger na mesma API do WhatsApp: uma instância, um padrão

API de Instagram Direct e Messenger oficiais na mesma API do WhatsApp: uma instância, um padrão Meta, o campo provider escolhe o canal. Sem criar app na Meta.

API não oficial do WhatsApp: recursos que a oficial não tem (com exemplos)

Recursos da API não oficial do WhatsApp (QR Code): botões, listas, enquete, figurinha, reação, grupos, status e Pix — com exemplos em cURL e Node.js.

Bot de IA no WhatsApp, Instagram e Messenger com n8n (template pronto)

Monte um bot de IA (GPT/OpenAI) que responde no WhatsApp, Instagram e Messenger num único fluxo do n8n. Template pronto WAME, com memória por contato.