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

> Errores comunes al crear, actualizar e importar contactos en el CRM.

<Tip>
  La mayoría de los problemas en contactos es **duplicado**, **alcance de la clave** o **límite del plan**.
</Tip>

## 409 — El contacto ya existe

**Causa:** correo, teléfono o identificador externo ya registrado en el espacio de trabajo.

**Qué hacer:**

1. `GET /v1/contacts` con filtro por correo o teléfono
2. Actualiza con `PUT /v1/contacts/{id}` en lugar de nuevo `POST`
3. En la importación, usa modo **upsert** si está disponible

***

## 403 — Sin permiso

**Causa:** API Key sin el alcance necesario (`contacts:read`, `contacts:create`, etc.).

**Qué hacer:** revisa [Alcances de la API Key](/es/contacts-api/como-funciona/escopos-da-api-key) y recrea o edita la clave en el panel.

***

## 403 — `PLAN_LIMIT_CRM`

**Causa:** límite de contactos o recurso CRM del plan alcanzado.

**Qué hacer:** upgrade de plan o limpia contactos obsoletos (según política del espacio de trabajo).

***

## 400 — Canal inválido

**Causa:** `channels` con tipo no soportado o sin identificador (correo sin `@`, teléfono sin DDI).

**Qué hacer:** normaliza teléfono (E.164) y valida correo antes del `POST`.

***

## Etiqueta o tema no aparece en el contacto

**Causa:** `tagIds` con ID incorrecto; tema solo vía preferencias o campo específico.

**Qué hacer:**

* Lista etiquetas: `GET /v1/tags`
* Confirma `PUT` con `tagIds` y alcance `contacts:update`
* Para temas, usa enlace de preferencias o flujo de opt-in documentado en [Temas](/es/contacts-api/como-funciona/topicos-de-comunicacao)

***

## Timeline vacía

**Causa:** contacto nuevo; eventos aún no sincronizados; falta `contacts:read` en sub-recursos.

**Qué hacer:** envía mensaje de prueba; espera webhook; verifica `GET /v1/contacts/{id}/timeline`.

***

## Próximos pasos

* [Inicio rápido](/es/contacts-api/como-funciona/quick-start)
* [Supresiones — troubleshooting](/es/suppressions-api/como-funciona/troubleshooting)