Skip to main content
La mayoría de los problemas en contactos es duplicado, alcance de la clave o límite del plan.

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

​
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