> ## 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 y situaciones comunes al trabajar con la lista de no contactar.

<Tip>
  La mayoría de los problemas caen en tres categorías: **identidad inválida**, **alcance de la clave** o **destinatario suprimido en el envío**.
</Tip>

## En resumen

* La supresión **no gasta crédito** ni llama al proveedor — el envío se detiene con `RECIPIENT_SUPPRESSED`.
* Fallas **transitorias** del proveedor no crean supresión automáticamente.
* Bounces permanentes, complaints y `STOP` son señales duraderas y pueden crear entrada solos.

***

## Códigos en la API de supresiones

| Código                      | Qué significa                                             | Qué hacer                                                            |
| --------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------- |
| `INVALID_SUPPRESSION_TYPE`  | `type` fuera de `email`, `phone`, `telegram`, `instagram` | Corrija el tipo                                                      |
| `INVALID_SUPPRESSION_VALUE` | El valor no pasó la normalización                         | Vea [Normalización](/es/suppressions-api/como-funciona/normalizacao) |
| `INVALID_BATCH_SIZE`        | Más de 100 ítems en el lote                               | Divida en varias llamadas                                            |
| `FORBIDDEN`                 | Clave sin `suppressions:read` o `suppressions:write`      | Actualice la API Key                                                 |
| `NOT_FOUND`                 | ID o identidad no existe (o ya fue eliminada)             | Verifique el workspace y el valor                                    |

***

## En el envío de mensajes

| Código                 | Qué significa                                    | Qué hacer                                                     |
| ---------------------- | ------------------------------------------------ | ------------------------------------------------------------- |
| `RECIPIENT_SUPPRESSED` | El destinatario está en la lista de no contactar | Consulte la entrada; elimine solo si tiene sentido de negocio |

<Warning>
  Eliminar la supresión **reactiva el envío al instante**. Si el problema original (bounce, spam, opt-out) continúa, la identidad puede volver a la lista automáticamente.
</Warning>

***

## Situaciones del día a día

<AccordionGroup>
  <Accordion title="El cliente envió STOP por SMS">
    El sistema crea supresión global de **teléfono**. SMS, WhatsApp, RCS y voz quedan bloqueados. Esto es distinto del unsubscribe de email marketing.
  </Accordion>

  <Accordion title="Importé CSV y algunas filas fallaron">
    En el lote (`batch/add`), cada fila tiene resultado individual. Las filas inválidas no impiden las válidas. Corrija solo las que devolvieron `invalid`.
  </Accordion>

  <Accordion title="Eliminé la supresión pero el envío sigue fallando">
    Verifique que eliminó el **valor normalizado** correcto. Use `DELETE /v1/suppressions/by-identity` con el mismo `type` y valor que está en la lista.
  </Accordion>

  <Accordion title="Supresión vs etiqueta vs tópico">
    **Etiqueta** organiza contactos. **Tópico** es consentimiento de marketing. **Supresión** **bloquea** el envío. Unsubscribe de email no bloquea SMS solo.
  </Accordion>
</AccordionGroup>

***

## Próximos pasos

* [Introducción](/es/suppressions-api/como-funciona/introducao): conceptos y diferencias
* [Eventos de webhooks](/es/suppressions-api/como-funciona/eventos-do-webhooks): seguir en tiempo real
* [Alcances de API Key](/es/suppressions-api/como-funciona/escopos-da-api-key): permisos