Quick Start

Pré-requisitos

• Uma conta na wiApi (acesso ao dashboard ou API key)
• Um número WhatsApp para conectar

1. Crie uma sessão

   cURL

   curl -X POST https://endpoint.wi.api.br/sessions \
     -H "x-api-key: SUA_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"name": "minha-sessao"}'

   JavaScript

   const res = await fetch("https://endpoint.wi.api.br/sessions", {
     method: "POST",
     headers: {
       "x-api-key": "SUA_API_KEY",
       "Content-Type": "application/json",
     },
     body: JSON.stringify({ name: "minha-sessao" }),
   });
   const { id } = await res.json();

   Resposta:

   { "id": "uuid-da-sessao", "name": "minha-sessao", "status": "disconnected" }

2. Conecte via QR Code

   curl https://endpoint.wi.api.br/sessions/{id}/qr \
     -H "x-api-key: SUA_API_KEY"

   A resposta contém o QR Code como imagem PNG em base64. Escaneie com seu WhatsApp.

3. Envie uma mensagem

   Use o header x-instance para indicar qual sessão deve enviar:

   curl -X POST https://endpoint.wi.api.br/chat/send/text \
     -H "x-api-key: SUA_API_KEY" \
     -H "x-instance: minha-sessao" \
     -H "Content-Type: application/json" \
     -d '{"to": "5511999999999@s.whatsapp.net", "text": "Olá da wiApi!"}'

   Resposta:

   { "success": true, "messageId": "3EB0A0B4F3..." }

Dica

O header x-instance aceita o nome ou ID da sessão. Também é possível usar o query param session_id como alternativa.

Próximos passos

• Configure webhooks para receber mensagens em tempo real
• Explore os tipos de mensagem suportados
• Veja como migrar de outro provider em Compatibilidade