Enriquecimento

Validar WhatsApp de um lead (até 10 números)

POST consome créditos

O preço desta operação para a sua conta fica em Configurações → Planos, já com o valor negociado do seu workspace.

Valida se cada número de um lead tem WhatsApp (via Evolution). Envie 1 lead com até 10 números; aceita formato livre (com/sem 55, com/sem o 9, máscara, 0 de discagem). Fixo também pode ter WhatsApp.

⚡ Consome créditos por número VERIFICADO com sucesso — tenha WhatsApp ou não. Número mal-formatado não é cobrado; se a validação falhar (Evolution fora do ar), nada é cobrado.

Rate limit: 60 req/min

01

Testar ao vivo

Autorização

Sua API key, gerada em /developer/api-keys. Gratuita para começar.

Sua requisição

curl -X POST 'https://tamz.ai/api/v1/enrichment/whatsapp' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "numbers": [
    "11999998888",
    "(21) 97167-8613"
  ]
}'
02

Corpo da requisição

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

03

Exemplo de retorno

{
  "data": {
    "lead_ref": "string",
    "results": [
      {
        "input": "string",
        "normalized": "string",
        "valid": true,
        "whatsapp": true,
        "jid": "string"
      }
    ]
  },
  "meta": {
    "credits_used": 0,
    "verified": 0,
    "invalid": 0
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API key. Use Authorization: Bearer tamz_xxx or X-API-Key header"
  }
}
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits",
    "required": 10,
    "available": 3,
    "upgrade_path": "/settings/plans",
    "next_action": "Top up credits and retry — zero-result searches are never charged."
  }
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded",
    "retry_after": 42
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}
04

Respostas e códigos

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

Começar grátis