> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Trust Factor

> Pontuação de confiança do workspace (0–1000), tiers de envio e o que afeta sua reputação na Notifique.

<Tip>
  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.
</Tip>

## 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**.

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

## 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                 |

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

## 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`:

```json theme={null}
{
  "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](/guides/conceitos/resposta-de-erros).

## Webhook `trust.score_changed`

Marque este evento no [webhook](/guides/webhooks/index) 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`).

```json theme={null}
{
  "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](/guides/webhooks/index).

## Boas práticas

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

***

## Próximos passos

* [Workspaces](/guides/workspaces/index)
* [Respostas de erro](/guides/conceitos/resposta-de-erros)
* [API de denúncias (FELCA)](/guides/compliance/report-api)
* [Segurança e confiabilidade](/guides/conceitos/seguranca-e-confiabilidade)