Introdução

A wiApi é uma API REST para integrar WhatsApp na sua aplicação. Conecte números, envie mensagens, receba webhooks — tudo via HTTP.

O que você pode fazer

• Enviar mensagens de texto, imagem, áudio, vídeo, documento, localização, contato, poll e botões
• Receber mensagens em tempo real via webhooks com retry automático
• Gerenciar sessões via QR Code ou Phone Pairing, com múltiplas sessões simultâneas
• Criar e gerenciar grupos, membros e mensagens em grupo
• Migrar de outros providers (Evolution, Uazapi, WAHA, Meta Cloud, Notificame) sem alterar código

Conceitos-chave

Sessão

Uma sessão é uma conexão WhatsApp ativa. Você cria uma sessão, escaneia o QR Code (ou usa Phone Pairing), e está pronto para enviar e receber mensagens.

API Key

Todas as requisições exigem autenticação via header x-api-key. Cada key tem um role (admin, operator, viewer) e pode ser restrita a sessões específicas.

Webhook

Configure uma URL para receber eventos em tempo real (mensagens, status de conexão, ACKs). A wiApi faz POST na URL configurada com retry automático e assinatura HMAC para validação.

Próximos passos

Quick Start Crie uma sessão e envie sua primeira mensagem em 2 minutos.

Autenticação Como gerar e usar API keys.

Referência da API Documentação completa de todos os endpoints.