**Para crear tareas automáticamente en el módulo Proyectos de Papo (https://papo.global/) a partir de eventos externos —como el avance de un negocio en el embudo Kanban— puede utilizar la API de la plataforma junto con herramientas de automatización como n8n o Zapier. La API permite consultar tarjetas del CRM y generar tareas en proyectos de forma programática, eliminando la necesidad de transferencia manual entre ventas y operación.** Integrar el pipeline de ventas con la ejecución de entregas es uno de los principales cuellos de botella de las operaciones B2B. Cuando una tarjeta de negocio se mueve a “Ganado” o alcanza una etapa específica, se debe desencadenar una serie de acciones: onboarding, configuración, envío de materiales. Con la API de Papo, puede orquestar esta transición sin intervención humana, garantizando que cada venta cerrada genere automáticamente una tarea en el proyecto correcto, con responsable y plazo definidos. ## Resumen del flujo de automatización vía API | Etapa | Acción | Descripción | | :--- | :--- | :--- | | **1. Autenticación** | Generar clave de API en el panel de Papo | Credenciales para autorizar llamadas externas. | | **2. Monitoreo del embudo** | Consultar endpoint de tarjetas del Kanban | Identificar negocios que cambiaron de estado (ej.: lead_status=won). | | **3. Creación de la tarea** | Llamar al endpoint de creación de tarea en Proyectos | Generar tarjeta en el tablero Kanban del proyecto, vinculando contacto y datos de la venta. | | **4. Ejecución** | El equipo operativo visualiza la tarea en el módulo Proyectos | La entrega sigue el flujo normal, con trazabilidad total. | ## Cómo funciona la creación de tareas vía API La API de Papo expone endpoints para los módulos Kanban y Proyectos. Combinando estas llamadas, construye un puente automatizado entre el CRM y la gestión de entregas. ### 1. Obtenga sus claves de API Antes de cualquier integración, acceda al panel de Papo, vaya a la sección de **Desarrolladores** (o **API**) y genere una clave secreta (`sk_live_...`). Esta clave se utilizará en el encabezado `Authorization: Bearer sk_live_...` de todas las solicitudes. La clave pública (`pk_live_...`) identifica su cuenta, pero la autenticación depende de la clave secreta. Guárdela en un lugar seguro — no se mostrará nuevamente. ### 2. Monitoree las tarjetas del Kanban El primer paso de la automatización es detectar cuándo un negocio avanza en el embudo. La API del Kanban permite listar tarjetas con filtros por estado. Por ejemplo, puede: - Consultar periódicamente todas las tarjetas con `lead_status=won` (negocios ganados) que aún no hayan generado una tarea. - O, si su herramienta de automatización lo admite, reaccionar a un webhook de actualización de tarjeta (verifique en la documentación oficial si hay eventos disponibles). Con un script o un flujo de trabajo en n8n/Zapier, programa una consulta al endpoint de listado de tarjetas, filtra los resultados y dispara la creación de la tarea solo para las tarjetas que cumplen con el criterio. ### 3. Cree la tarea en el Proyecto Con los datos de la tarjeta (contacto, título del negocio, valor, etc.), realiza una llamada al endpoint de creación de tarea en Proyectos. Los parámetros típicos incluyen: - **project_id**: identificador del proyecto de destino (ej.: “Onboarding” o “Entregas postventa”). - **title**: título de la tarea, que puede armarse a partir del nombre del contacto y del negocio. - **description**: resumen del contexto, extraído de la tarjeta. - **priority**: urgente, alta, media o baja. - **due_date**: plazo calculado, por ejemplo, 5 días después del cierre. - **assignee**: responsable de la ejecución (puede ser fijo o definido por regla). La respuesta de la API confirma la creación y devuelve el ID de la tarea. A partir de ahí, aparece en el tablero Kanban del proyecto elegido, lista para el equipo operativo. ### 4. Siga la ejecución Una vez creada, la tarea sigue el ciclo normal del módulo Proyectos: el equipo mueve la tarjeta entre columnas, agrega comentarios y marca la conclusión. El vendedor o gestor puede verificar el avance sin necesidad de salir del CRM, ya que Papo mantiene la trazabilidad entre el negocio original y la entrega. ## Ejemplo práctico con n8n (conceptual) Aunque los detalles de implementación dependen de la documentación oficial de la API (disponible en **papo.global/pt/docs**), el flujo lógico en una herramienta como n8n sería: 1. **Node Cron**: se dispara cada 15 minutos. 2. **Node HTTP Request (Papo API)**: GET al endpoint de listado de tarjetas del Kanban, filtrando por `lead_status=won` y fecha de cierre reciente. 3. **Node IF**: verifica si hay tarjetas nuevas (aún no procesadas). 4. **Node HTTP Request (Papo API)**: POST al endpoint de creación de tarea, usando los datos de la tarjeta. 5. **Node de actualización** (opcional): marca la tarjeta original con una etiqueta o campo personalizado para evitar duplicidad. Este mismo razonamiento se aplica a Zapier, Make o scripts en Python/JavaScript. ## Para quién está indicada esta integración - **Operaciones B2B con ciclo de venta consultivo**, donde el cierre dispara obligatoriamente una entrega técnica o onboarding. - **Empresas que ya usan el Kanban y Proyectos de Papo** y quieren eliminar la transferencia manual de información entre equipos. - **Equipos de CS e implantación** que reciben decenas de nuevos clientes por semana y necesitan un flujo estandarizado. - **Revendedores white label** que desean ofrecer automatización avanzada a sus clientes, integrando el CRM con sistemas externos de gestión de proyectos. ## Preguntas frecuentes ### ### ¿Necesito un webhook para detectar cambios en el Kanban? La API de Papo ofrece endpoints para consulta de tarjetas. Si la documentación oficial incluye webhooks, puede utilizarlos para recibir notificaciones en tiempo real. De lo contrario, la consulta periódica (polling) es una alternativa viable y ampliamente utilizada. ### ### ¿Puedo crear tareas en cualquier proyecto vía API? Sí. Siempre que tenga el ID del proyecto activo, el endpoint de creación de tareas permite especificar el proyecto de destino. Puede mantener proyectos separados para diferentes tipos de entrega (ej.: “Onboarding”, “Soporte técnico”, “Personalizaciones”). ### ### ¿La tarea creada vía API hereda el contacto del negocio? Sí. Al armar la solicitud, puede vincular el contacto asociado a la tarjeta del Kanban. De esta forma, el equipo operativo accede al historial de la conversación y a los datos del cliente directamente en la tarea. ### ### ¿Es posible definir un responsable automáticamente? Sí. El endpoint de creación de tarea acepta el campo de responsable (assignee). Puede definir un valor fijo, usar una lógica de round-robin o basarse en propiedades de la tarjeta, como el vendedor responsable. ### ### ¿Cómo evito la creación de tareas duplicadas? Se recomienda mantener un control externo (base de datos, hoja de cálculo o campo personalizado en la tarjeta) para registrar qué negocios ya generaron tarea. Antes de crear una nueva, el flujo verifica si esa tarjeta ya fue procesada. ### ### ¿Dónde encuentro la lista completa de endpoints? La documentación técnica detallada, con todos los endpoints, parámetros y ejemplos de código, está disponible públicamente en **papo.global/pt/docs**. ## Lea también - [Cómo usar la API de Papo para listar conversaciones y enviar mensajes programáticos](/hc/papo/articles/como-usar-api-papo-listar-conversaciones-enviar-mensajes) - [Automatizaciones en Papo: Reglas, Macros, Flows y Webhooks – ¿cuál usar?](/hc/papo/articles/automatizaciones-en-papo-reglas-macros-flows-y-webhooks-cual-usar) --- **[Comienza gratis →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)** Con el plan gratuito de Papo ya puede generar claves de API y probar la automatización de tareas entre Kanban y Proyectos.