Skip to main content
Cinco familias: contacts, tags, topics, segments, campaigns. Las campañas también exigen alcances de envío por canal (whatsapp:send, sms:send, …).
Cada alcance desbloquea un tipo de operación en Contactos. Use solo lo que su integración necesita.

​
Cómo enviar la clave

Recomendado
Alternativo
Cada clave API pertenece a un espacio de trabajo. No puede acceder a otro espacio de trabajo con la misma clave.

​
Combinaciones comunes

Solo leer base

contacts:read, tags:read

Sincronizar CRM

contacts:read, contacts:create, contacts:update, tags:read, tags:create

Campañas vía API

campaigns:read, campaigns:create, campaigns:run + alcances de envío de los canales

Gestión completa

Todos los contacts:*, tags:*, topics:*, segments:*, campaigns:*
Lista de alcances vacía al crear = acceso ADMIN (todo). En producción, restrinja siempre.

​
Contactos (contacts:*)

Listar y obtener contacto por ID.
Crear contacto (teléfono y/o correo obligatorio).
Editar ficha, etiquetas y campos.
Eliminar contacto.

​
Etiquetas (tags:*)

Listar y obtener etiqueta.
Crear etiqueta reutilizable.
Renombrar etiqueta.
Eliminar etiqueta.

​
Temas (topics:*)

Consentimiento por tema de marketing (Newsletter, Promociones). Igual que en el panel en Audience → Topics.
Listar y obtener tema.
Crear tema con slug estable.
Editar nombre, descripción y opt-in predeterminado.
Eliminar tema.

​
Segmentos (segments:*)

Audiencias con reglas (etiquetas, campos, temas, marketing). Incluye preview antes de campañas.
Listar, obtener y preview (muestra paginada de la audiencia).
Crear segmento con JSON version: 1, match, rules.
Editar reglas del segmento.
Eliminar segmento.

​
Campañas (campaigns:*)

Listar, obtener, estadísticas y destinatarios por ejecución.
Crear campaña (opcionalmente con scheduledFor).
Editar campaña y cancelar (DRAFT/SCHEDULED → CANCELLED).
Eliminar campaña.
Disparar ahora (Run); encola envíos en los canales de la campaña.
Disparar una campaña exige campaigns:run y alcances de envío de cada canal (whatsapp:send, sms:send, email:send, telegram:send) cuando la cola procese mensajes.

​
Errores comunes

Verifique el alcance de la operación (Missing scope: contacts:read, etc.).
Plan o límite PLAN_LIMIT_CRM. Regularice en el panel.
Teléfono o correo ya registrado en el espacio de trabajo.

​
Próximos pasos