Início Rápido
Este guia mostra como criar uma instância, conectá-la e enviar sua primeira mensagem.
Pré-requisitos
- Uma conta Wappfy (cadastre-se)
- Um número WhatsApp para conectar
- Uma chave de API ou token JWT do Supabase
Passo 1: Obtenha sua chave de API
curl -X POST https://api.wappfy.io/api/api-keys \
-H "Authorization: Bearer SEU_JWT_SUPABASE" \
-H "Content-Type: application/json" \
-d '{ "name": "Minha Primeira Chave" }'
Salve o valor retornado no campo key — ele só é exibido uma única vez.
Passo 2: Crie uma instância
curl -X POST https://api.wappfy.io/api/instances \
-H "X-Api-Key: SUA_CHAVE_API" \
-H "Content-Type: application/json" \
-d '{
"name": "WhatsApp Produção",
"instance_type": "waha"
}'
id retornado — você o usará em todas as requisições seguintes.
Passo 3: Conecte via QR code
# Iniciar a conexão
curl -X POST https://api.wappfy.io/api/instances/ID_DA_INSTANCIA/connect \
-H "X-Api-Key: SUA_CHAVE_API"
# Obter o QR code
curl https://api.wappfy.io/api/instances/ID_DA_INSTANCIA/qr \
-H "X-Api-Key: SUA_CHAVE_API"
qr (imagem base64).
Passo 4: Envie uma mensagem
Quando o status da instância estiver como connected, você pode enviar sua primeira mensagem:
curl -X POST https://api.wappfy.io/api/instances/ID_DA_INSTANCIA/messages/send \
-H "X-Api-Key: SUA_CHAVE_API" \
-H "Content-Type: application/json" \
-d '{
"to": "5511999999999",
"type": "text",
"body": "Olá da Wappfy!"
}'
Resposta
{
"success": true,
"data": {
"message": "Message queued for delivery",
"jobId": "12345"
},
"meta": {
"requestId": "req_abc123",
"timestamp": "2026-02-10T12:00:00.000Z"
}
}
Próximos passos
