Activepieces
Conecta Activepieces como fuente de datos de webhook: cómo el componente de Instasent envía contactos y eventos al stream de ingesta de Instasent, qué sincroniza, cómo se asignan los campos a los atributos y cómo se controla el consentimiento a través de los datos que envías.
Activepieces es una plataforma de webhooks: en vez de leer tus datos directamente, te permite construir una automatización que envía contactos y eventos al stream de ingesta de Instasent. Úsalo para conectar Instasent con cualquier herramienta que Activepieces admita y que no tenga conector nativo.
Cómo conectar
Activepieces es una plataforma de webhooks: no creas ninguna credencial en el lado de Activepieces — Instasent crea la fuente y te da las credenciales, y tú las usas en el componente de Instasent. Puedes hacer el lado de Instasent antes de tener nada configurado en Activepieces; la fuente queda creada esperando datos en tiempo real.
El componente de Instasent está preinstalado y ya disponible en Activepieces, así que
en la versión en la nube no hay nada que instalar — solo usas sus acciones con tus
credenciales. En una instalación autogestionada donde no esté presente, instala el
componente @activepieces/piece-instasent.
Añade la fuente de datos
En Fuentes de datos, selecciona Añadir fuente de datos y selecciona Activepieces en la sección de Integraciones.
Configura la fuente
Rellena el paso Configurar — Nombre de la conexión, País por defecto, Configuración regional / Locale y Zona horaria — e Instasent crea la fuente.
Copia tus credenciales
Instasent muestra las credenciales de la fuente en Instrucciones de configuración — el UID de proyecto, el ID Fuente de datos y la API key. Guárdalos en lugar seguro.
Usa el componente de Instasent
En tu flujo de Activepieces, añade el componente de Instasent y usa sus acciones para enviar contactos y eventos, con las credenciales del panel. En instalaciones autogestionadas donde no esté, instala antes
@activepieces/piece-instasent. Los contactos se añaden a tu audiencia de forma inmediata.Observa el registro de stream
De vuelta en Instasent, la fuente muestra un registro de stream de los datos que llegan, para que confirmes que tu flujo funciona.
Para las formas de los endpoints y las credenciales completas, consulta API y webhooks.
Qué sincroniza
Activepieces envía lo que tu flujo emita — normalmente contactos y eventos, en
tiempo real según se ejecuta el flujo. El payload sigue el formato de ingesta: un
payload de contacto identifica al contacto (contact_id); un payload de evento añade el
nombre del evento y sus parámetros.
Mapeo de campos
Los campos que envías se asignan a atributos de Instasent igual que en cualquier fuente — decides en tu flujo qué valores van a qué campos, y confirmas el mapeo. Consulta el mapeo de campos.
Mapeo de consentimiento
Activepieces no tiene mapeo de consentimiento propio — simplemente deja pasar los datos
que tu flujo envía. El consentimiento se controla con las columnas y atributos que
incluyes en el payload. Si envías los atributos de consentimiento
(_accepts_marketing_*, _is_subscribed_*), aplican las mismas reglas que en cualquier
importación: fija _accepts_marketing_* en false solo ante un opt-out activo; "sin
dato" se queda en null. Consulta
Consentimiento.