**Para gestionar Secuencias de seguimiento vía API en [Papo](https://papo.global/), puedes listar las cadencias disponibles, matricular contactos y pausar la participación de un lead usando la actualización de atributos personalizados — todo mediante solicitudes autenticadas, sin abrir el panel. Es la forma de integrar la nutrición de leads a CRMs, ERPs y flujos de automatización externos.** ## Resumen de las operaciones vía API | Operación | Descripción | Cómo lo realiza la API | | :--- | :--- | :--- | | **Listar secuencias** | Obtener todas las cadencias de seguimiento de la cuenta, con nombre, identificador y estado (activo/inactivo). | Solicitud GET autenticada en el endpoint de flows, filtrando por el tipo "sequence". | | **Matricular contacto** | Insertar un contacto existente en una secuencia activa, iniciando el recorrido de mensajes. | POST con el ID del contacto y el ID de la secuencia en el endpoint de matrícula. | | **Pausar cadencia para un contacto** | Interrumpir temporalmente los envíos para un lead sin eliminarlo de la secuencia. | Actualización del atributo personalizado del contacto (ej.: `status_pausa`) vía API de contactos, combinada con condición en el Flow. | ## Cómo funciona la autenticación y los endpoints Todas las operaciones usan la API REST de Papo, autenticada con la **clave secreta** de la cuenta (token Bearer). La URL base es `https://app.papo.global/api/v1`. Las claves se generan en el panel, en el área de desarrollador. Los recursos de secuencias están agrupados en los endpoints de **flows**. La API permite listar todos los flows, incluidos los del tipo "sequence", y también activar/desactivar un flow completo. Para matricular un contacto, hay un endpoint específico que recibe el identificador del contacto y el del flow. Los detalles exactos de cada endpoint (parámetros, payloads y ejemplos) están disponibles en la documentación oficial de la API de Papo. Aquí, nos enfocamos en el flujo de trabajo para gestionar secuencias de seguimiento. ## Paso a paso: listar, matricular y pausar ### 1. Listar las secuencias disponibles Antes de matricular leads, necesitas saber qué secuencias existen y sus identificadores. La llamada de listado devuelve una relación con nombre, ID y estado (activo/inactivo). Solo las secuencias activas aceptan nuevas matrículas. Con la lista en mano, tu sistema externo puede mapear qué secuencia usar para cada lead. ### 2. Matricular un contacto en una secuencia Con el ID del contacto (obtenido vía búsqueda o creación por la API de contactos) y el ID de la secuencia activa, envías una solicitud para insertarlo al inicio del recorrido. El contacto debe existir en el CRM de Papo; de lo contrario, créalo antes usando el endpoint de contactos. La matrícula inicia inmediatamente el envío de los mensajes programados, respetando los intervalos configurados en el Flow. El historial del contacto se preserva. ### 3. Pausar la cadencia para un contacto específico La API de Papo no tiene un comando directo para "pausar" la participación de un contacto en una secuencia. Sin embargo, puedes obtener el mismo efecto combinando la API de contactos con una condición en el Flow. **Requisito previo:** la secuencia debe haberse construido con un nodo de condición que verifica un atributo personalizado (ej.: `status_pausa`). Si el atributo es igual a "pausado", la condición bloquea el envío de los próximos mensajes; de lo contrario, lo libera. (Ver el artículo sobre pausa temporal para detalles de armado del Flow.) Con esta estructura en el Flow, la pausa se realiza en dos pasos vía API: 1. **Identifica el contacto** por ID o búscalo por teléfono/email usando el endpoint de listado de contactos. 2. **Actualiza el atributo personalizado** del contacto a "pausado" (o el valor que tu condición espere). Utiliza el endpoint de actualización de contacto, enviando el campo personalizado. A partir de ese momento, cuando el flujo llegue a la condición, identificará el valor "pausado" y no enviará el mensaje. Para reanudar, basta con actualizar el atributo a cualquier otro valor (ej.: "activo") o limpiarlo, y el contacto continuará desde donde se quedó. Este método mantiene al contacto matriculado y el progreso en la cadencia, sin perder el historial. ## Para quién es útil esta integración - **Operaciones de SDR y ventas B2B** que disparan secuencias a partir de eventos externos (ej.: un lead descargó un material, se creó un negocio en el CRM). - **Revendedores white label** que provisionan recorridos de seguimiento automáticamente para nuevos clientes, matriculando contactos iniciales sin acción manual. - **Equipos de marketing y automatización** que usan herramientas como n8n o Zapier para conectar Papo a decenas de sistemas y necesitan control granular sobre las cadencias. - **Empresas con procesos de pausa condicional**, donde un lead pide un tiempo y el vendedor quiere interrumpir la secuencia sin perder el punto de la cadencia — todo accionado por un botón en el CRM externo. ## Preguntas frecuentes ### ¿Necesito la clave secreta para listar secuencias? Sí. Toda operación que devuelve datos de la cuenta requiere autenticación con la clave secreta, enviada como token Bearer en el encabezado `Authorization`. ### ¿Puedo matricular un contacto que aún no existe en Papo? No. El contacto debe existir en el CRM de Papo. Puedes crearlo primero vía API de contactos (con nombre, teléfono o email) y luego matricularlo en la secuencia. ### ¿La API permite eliminar un contacto de la secuencia? La eliminación (cancelación de la matrícula) no está disponible como endpoint específico en la versión actual. La alternativa para interrumpir los envíos es pausar vía atributo personalizado, según lo descrito, o desactivar el flow completo, lo que afecta a todos los contactos. ### ¿Cómo sé si la pausa por atributo funcionó? Después de actualizar el atributo, la secuencia continuará procesando los nodos de espera. Cuando llegue a la condición, verificará el valor. Si está "pausado", el mensaje no se enviará. Puedes confirmar en el perfil del contacto, en el módulo de Contactos, que permanece matriculado, pero los próximos mensajes no se disparan. ### ¿Puedo pausar la secuencia completa vía API? Sí. La API permite cambiar el estado de un flow a inactivo, pausando la secuencia para todos los contactos. Usa el endpoint de activación/desactivación de flow. Para reanudar, basta con reactivarlo. ### ¿Dónde encuentro los endpoints exactos y ejemplos de código? La documentación completa de la API está disponible en [https://papo.global/pt/docs](https://papo.global/pt/docs). Allí encuentras los endpoints de flows, contactos y los formatos de solicitud. ## Lea también - [Cómo usar la API de Papo para gestionar Flows de automatización](/hc/papo/articles/como-usar-api-papo-gestionar-flows-automatizacion) - [Cómo usar la API de Papo para crear y actualizar contactos en masa](/hc/papo/articles/como-usar-la-api-de-papo-para-crear-y-actualizar-contactos-en-masa) --- **[Comienza gratis y automatiza tus secuencias →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=como-usar-api-papo-gestionar-secuencias-seguimiento&utm_content=es)** Con la API de Papo, integras la nutrición de leads directamente a tu stack, sin abrir el panel — el primer usuario es gratuito para que lo pruebes.