Trust Factor

Trust Factor é o score de crédito do seu workspace: boa conduta libera envios; abuso, spam e conteúdo bloqueado reduzem o teto diário.

Em poucas palavras

Score de 0 a 1000, compartilhado por todo o workspace (não por API Key).
Tiers verde, amarelo e vermelho definem limite diário de saída (UTC).
Sandbox (sk_test_) não consome cota do Trust Factor.
Limite é adicional a créditos, plano e rate limit da API.
Acompanhe no painel em Workspace → Settings → Trust Factor.

O Trust Factor é por workspace. Todas as chaves e canais do mesmo workspace compartilham pontuação e limite diário.

Tiers e limites

Pontuação	Tier	Limite diário de saída (UTC)
700 – 1000	Verde	Ilimitado
300 – 699	Amarelo	1.000 mensagens
0 – 299	Vermelho	100 mensagens

Workspaces novos começam em 800 (verde).
O contador reinicia à meia-noite UTC.
Cada destinatário em envio de saída conta 1, somando WhatsApp, SMS, e-mail, push, RCS, Telegram e Instagram.

O que reduz o score

Repetir o mesmo tipo de violação em 24 h aumenta a penalidade (até 3× o valor base).

Evento	Impacto base (pts)
Conteúdo malicioso bloqueado	−80
Imitação de alerta governamental	−60
Conteúdo adulto bloqueado	−50
Injeção de prompt em fluxos de IA	−40
Restrição de conta WhatsApp Oficial	−40
Qualidade WhatsApp Oficial vermelha	−35
Reclamação de spam (e-mail)	−30
Conteúdo ofensivo bloqueado	−20
Qualidade WhatsApp Oficial amarela	−15
Desconexão inesperada do canal	−12
Limite de envio WhatsApp Oficial reduziu	−10
Hard bounce (e-mail)	−2
Soft bounce (e-mail)	−1

Conteúdo bloqueado não é enviado, mas a tentativa pode reduzir o score. Trate UNSAFE_CONTENT e similares como alerta de reputação.

Recuperação

Sem novas violações graves, o score sobe aos poucos:

Situação nos últimos 7 dias	Recuperação/dia
Nenhuma penalidade	+5 pts
Só penalidades leves (bounces)	+2 pts
Penalidade média, alta ou crítica	0

Erro na API

Teto do tier atingido → HTTP 429 TRUST_DAILY_LIMIT:

{
  "success": false,
  "error": "Too Many Requests",
  "message": "Daily send limit reached for Trust Factor (1000/1000). Improve your workspace trust score to send more.",
  "code": "TRUST_DAILY_LIMIT",
  "trustTier": "YELLOW",
  "dailyLimit": 1000,
  "dailyUsed": 1000,
  "trustScore": 650
}

Detalhes em Respostas de erro.

Webhook `trust.score_changed`

Marque este evento no webhook se precisa reagir quando a reputação sobe ou desce (spam, bounce, qualidade WhatsApp, conteúdo bloqueado, etc.).

Evento	Quando dispara	O que fazer
`trust.score_changed`	Qualquer delta no score	Alertar time, reduzir volume ou pausar campanhas

direction é up ou down. reason e type explicam a causa (ex.: EMAIL_COMPLAINT, WA_QUALITY_RED).

{
  "event": "trust.score_changed",
  "workspaceId": "clxx...",
  "instanceId": "",
  "timestamp": "2026-07-25T16:20:00.000Z",
  "data": {
    "trustEventId": "clxx...",
    "type": "EMAIL_COMPLAINT",
    "severity": "HIGH",
    "channel": "email",
    "deltaPoints": -30,
    "scoreBefore": 800,
    "scoreAfter": 770,
    "tierBefore": "GREEN",
    "tierAfter": "GREEN",
    "direction": "down",
    "reason": "Email spam complaint",
    "metadata": {
      "recurrenceCount24h": 1,
      "multiplier": 1
    }
  }
}

Formato geral do POST, headers e retentativas: Webhooks.

Boas práticas

Não reenvie conteúdo bloqueado, cada tentativa pode penalizar de novo.
Higienize listas de e-mail para reduzir bounces e spam complaints.
Trate 429 TRUST_DAILY_LIMIT separado do rate limit genérico da API.

Guias simples

Conheça mais

Workspaces

IA e no-code

BYOK

Em poucas palavras

Tiers e limites

O que reduz o score

Recuperação

Erro na API

Webhook `trust.score_changed`

Boas práticas

Próximos passos

​Em poucas palavras

​Tiers e limites

​O que reduz o score

​Recuperação

​Erro na API

​Webhook trust.score_changed

​Boas práticas

​Próximos passos

Em poucas palavras

Tiers e limites

O que reduz o score

Recuperação

Erro na API

Webhook `trust.score_changed`

Boas práticas

Próximos passos