A plataforma de mensagens com IA que sempre quis construir — já está pronta.
API v2/v3, SDK, webhooks. Faz tudo.
Conta grátis. Sem completar onboarding guiado. Chave gerada em Definições → API Keys.
Aria
Assistente IA · OnlineSem fluff, só o que está em produção
O Swagger é gerado a partir do código. Nunca o contrário.
A pergunta que mais nos fazem é directa: "o que acontece se um cliente de outro tenant vir os meus dados?" — a primeira coisa que qualquer developer precisa de confirmar antes de confiar dados de produção a uma plataforma multi-tenant.
O tenantId é propagado em cada pedido — da autenticação à query na base de dados — nunca inferido a meio da cadeia.
Sabe exactamente como o isolamento entre tenants funciona antes de integrar, sem ter de acreditar apenas na palavra escrita — é a resposta directa, não um argumento de marketing.
Superfície de API
17 endpoints básicos. 60 endpoints de plataforma completa. Um envelope de resposta só.
Integra mensageria numa plataforma de terceiros e a documentação está desactualizada, os endpoints mudam sem aviso, e descobre em produção que um rate limit não documentado está a devolver 429 sem explicação.
API v1/v2 — cerca de 17 endpoints REST para tickets, mensagens e contactos, a base para quem só precisa do essencial. API v3 "Full Platform" — cerca de 60 endpoints em 15 módulos: mensagens, contactos, tickets, campanhas, flows, agentes de IA, base de conhecimento, analytics, webhooks, templates, produtos, filas, equipas, respostas rápidas e mensagens agendadas. Toda a API v2/v3 usa um envelope de resposta padrão, sem variações por endpoint: em caso de sucesso, `{ data, meta: { requestId, timestamp }, pagination }` (pagination só em listagens); em caso de erro, `{ error, message, meta: { requestId, timestamp } }`. Os rate limits são definidos por categoria, não por um único número global: leitura/listagem (contactos, tickets, campanhas…) até 300 pedidos/min, envio de mensagem 60 pedidos/min, envio em massa (bulk) 10 pedidos/min, e o limite geral da chave é 1000 pedidos/min, configurável por chave, sem afinação por endpoint. Cada resposta traz os cabeçalhos `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset`; ao exceder, recebe `429` com `Retry-After`.
Sabe exactamente quantos pedidos pode fazer antes de escrever a primeira linha de código de integração — não descobre o limite em produção.
Não precisa de reconstruir o cliente HTTP
SDK, n8n, Zapier, Make. A ligação já está feita — falta o seu caso de uso.
Cada integração nova significa escrever outro cliente HTTP, outro parser de erros, outra lógica de retry — tempo que devia ir para a lógica de negócio do cliente, não para reinventar o wrapper da API.
SDK JavaScript/TypeScript oficial (`@whatsms/sdk`) — cliente sobre `axios`, tipos completos, paginação tipada, tratamento de erros por classe HTTP e retries automáticos com backoff exponencial em falhas 5xx; fala com a API v2/v3 conforme o addon activo na sua conta. Conector n8n (`n8n-nodes-whatsms`) — nó de acção (mensagens, tickets, contactos) e nó de trigger, autenticados por API key. Zapier e Make — sem app nativo no marketplace: liga-se via Webhooks by Zapier / módulo HTTP do Make aos seus webhooks outbound e à API REST, o mesmo caminho documentado em `docs/integrations/zapier.md` e `docs/integrations/make.md`. Webhooks outbound — eventos como `ticket.created` ou `message.received`, com retry automático e desactivação após falhas consecutivas, para não ficar a apanhar entregas perdidas manualmente.
A camada de transporte (auth, retries, paginação, parsing de erro) já está resolvida. O que resta escrever é a lógica específica do cliente.
Não é um PDF desactualizado
Swagger completo, sincronizado com o código.
Documentação de API que fica desactualizada é pior do que não ter documentação nenhuma — testa um endpoint que já não existe, ou que mudou de forma sem aviso.
Especificação OpenAPI 3.1 gerada directamente das rotas em produção — três versões, três Swagger UIs: `/api-docs` (v1), `/api-docs/v2` e `/api-docs/v3`. Testa pedidos reais, com autenticação por chave, sem sair do browser.
Confirma o comportamento real de um endpoint antes de escrever uma linha de código de integração, directamente no browser.
Comece sem passar pela conversa
Três passos. Zero configuração guiada.
Onboarding conversacional é ideal para quem prefere ser guiado passo a passo — mas atrasa quem só quer testar a API antes de decidir se a plataforma serve o seu caso de uso.
Crie a conta grátis — formulário, sem onboarding conversacional; plano Free permanente, sem cartão. Gere uma API key — Definições → API Keys, sem precisar de completar nenhum passo de configuração da IA para lá chegar. Chame a API: `curl https://api.whatsms.ai/api/v3/contacts?page=1&perPage=25 -H "Authorization: Bearer wsk_live_xxxxxxxxxxxxxxxx"` — também aceite como `X-API-Key: <chave>`, para clientes HTTP que não suportam `Bearer` custom. Sem o addon `api-full` activo, a resposta é honesta em vez de ambígua: `{ "error": "addon_required", "meta": { "requestId": "…", "timestamp": "…" } }`.
Da conta criada à primeira chamada API, sem qualquer passo de configuração conversacional pelo meio.
Preço claro, sem letras miúdas
Um addon, não um plano à parte.
Perceber quanto vai realmente pagar por acesso à API costuma exigir ler a letra miúda de um plano enterprise à parte, só para descobrir depois que falta outro addon escondido.
API v1/v2 (mensagens, tickets, contactos) — addon Acesso API v2, 9,90€/mês. API v3 "Full Platform" (60 endpoints, 15 módulos) — addon API Completa, 39€/mês nos planos Starter e Pro, incluído sem custo no plano Agency. Starter é 49€/mês (39€/mês anual), Pro é 99€/mês (79€/mês anual), Agency é 249€/mês (199€/mês anual). 14 dias grátis, sem cartão. Adiciona um cartão e ganha 30 dias.
Sabe exactamente quanto vai pagar pelo acesso à API antes de integrar — sem surpresas escondidas atrás de um plano enterprise à parte.