Skip to main content

Autenticação

Todas as requisições autenticadas usam Bearer token no header HTTP:

Obtendo sua API Key

  1. Acesse app.thatsme.com.br/settings/integrations
  2. Clique em Nova chave de API
  3. Dê um nome descritivo (ex: “Integração n8n”, “Script Python”)
  4. Copie a chave — ela não será exibida novamente
Nunca exponha sua API key em código público, repositórios ou frontend. Trate como uma senha.

Fazendo sua primeira requisição

Ambientes

Use sempre o ambiente Sandbox durante o desenvolvimento. Emissões no Sandbox não enviam WhatsApp nem email reais.

Acesso por plano

A API é a mesma em todos os planos, inclusive no Free: leitura e escrita, emitir certificados, criar e gerenciar eventos, webhooks. O que muda entre os planos é a cota de emissões por mês — e o rate limit, que é proteção de infraestrutura, não recurso de plano.
Rate limit é aplicado por organização, não por IP. Todas as suas API keys compartilham o mesmo balde.
Quando o limite é atingido, a API retorna 429 Too Many Requests com o header Retry-After indicando quantos segundos aguardar.

Erros de autenticação

Exemplo de resposta de erro

Referência completa de erros

Veja todos os códigos de erro e boas práticas de tratamento.