Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.thatsme.com.br/llms.txt

Use this file to discover all available pages before exploring further.

​
Autenticação

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

​
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

curl https://api.thatsme.com.br/api/v1.0/events \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json"

​
Ambientes

AmbienteURL baseQuando usar
Produçãohttps://api.thatsme.com.br/apiDados reais
Sandboxhttps://servicetest.thatsme.com.br/apiTestes e desenvolvimento
Use sempre o ambiente Sandbox durante o desenvolvimento. Emissões no Sandbox não enviam WhatsApp nem email reais.

​
Tiers de acesso

PlanoTier APIAcesso
Free—Sem acesso à API
StarterBasicLeitura (listar eventos, badges, destinatários)
ProAdvancedLeitura + escrita (emitir certificados, webhooks)
BusinessAdvancedMesmo que Pro, com rate limits maiores
EnterpriseAdvancedRate limits customizados

​
Rate limits

PlanoLimite
Starter100 requisições/minuto
Pro1.000 requisições/minuto
Business1.000 requisições/minuto
EnterpriseCustomizado
Quando o limite é atingido, a API retorna 429 Too Many Requests com o header Retry-After indicando quantos segundos aguardar.

​
Erros de autenticação

CódigoMensagemCausa
401UnauthorizedAPI key ausente, inválida ou revogada
403ForbiddenPlano insuficiente para o endpoint
429Too Many RequestsRate limit atingido

​
Exemplo de resposta de erro

{
  "statusCode": 401,
  "message": "Invalid API key",
  "error": "Unauthorized"
}

Referência completa de erros

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