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

# Troubleshooting

> Códigos e situações comuns ao trabalhar com a lista de não contatar.

<Tip>
  A maioria dos problemas cai em três categorias: **identidade inválida**, **escopo da chave** ou **destinatário suprimido no envio**.
</Tip>

## Em poucas palavras

* Supressão **não gasta crédito** nem chama o provedor — o envio para com `RECIPIENT_SUPPRESSED`.
* Falhas **transitórias** do provedor não criam supressão automaticamente.
* Bounces permanentes, complaints e `STOP` são sinais duráveis e podem criar entrada sozinhos.

***

## Códigos na API de supressões

| Código                      | O que significa                                          | O que fazer                                                       |
| --------------------------- | -------------------------------------------------------- | ----------------------------------------------------------------- |
| `INVALID_SUPPRESSION_TYPE`  | `type` fora de `email`, `phone`, `telegram`, `instagram` | Corrija o tipo                                                    |
| `INVALID_SUPPRESSION_VALUE` | Valor não passou na normalização                         | Veja [Normalização](/suppressions-api/como-funciona/normalizacao) |
| `INVALID_BATCH_SIZE`        | Mais de 100 itens no lote                                | Divida em várias chamadas                                         |
| `FORBIDDEN`                 | Chave sem `suppressions:read` ou `suppressions:write`    | Atualize a API Key                                                |
| `NOT_FOUND`                 | ID ou identidade não existe (ou já foi removida)         | Confira o workspace e o valor                                     |

***

## No envio de mensagens

| Código                 | O que significa                            | O que fazer                                               |
| ---------------------- | ------------------------------------------ | --------------------------------------------------------- |
| `RECIPIENT_SUPPRESSED` | Destinatário está na lista de não contatar | Consulte a entrada; remova só se fizer sentido de negócio |

<Warning>
  Remover a supressão **reativa o envio na hora**. Se o problema original (bounce, spam, opt-out) continuar, a identidade pode voltar para a lista automaticamente.
</Warning>

***

## Situações do dia a dia

<AccordionGroup>
  <Accordion title="Cliente mandou STOP no SMS">
    O sistema cria supressão global de **telefone**. SMS, WhatsApp, RCS e voz ficam bloqueados. Isso é diferente de unsubscribe de e-mail marketing.
  </Accordion>

  <Accordion title="Importei CSV e algumas linhas falharam">
    No lote (`batch/add`), cada linha tem resultado individual. Linhas inválidas não impedem as válidas. Corrija só as que retornaram `invalid`.
  </Accordion>

  <Accordion title="Removi supressão mas o envio ainda falha">
    Confira se removeu o **valor normalizado** correto. Use `DELETE /v1/suppressions/by-identity` com o mesmo `type` e valor que está na lista.
  </Accordion>

  <Accordion title="Supressão vs tag vs tópico">
    **Tag** organiza contatos. **Tópico** é consentimento de marketing. **Supressão** **bloqueia** envio. Unsubscribe de e-mail não bloqueia SMS sozinho.
  </Accordion>
</AccordionGroup>

***

## Próximos passos

* [Introdução](/suppressions-api/como-funciona/introducao): conceitos e diferenças
* [Eventos dos webhooks](/suppressions-api/como-funciona/eventos-do-webhooks): acompanhar em tempo real
* [Escopos da API Key](/suppressions-api/como-funciona/escopos-da-api-key): permissões