API y webhooks
Haz entrar contactos y eventos de forma programática: la API de Ingesta de Instasent y las plataformas de webhooks. Qué te prepara el panel —la fuente, sus credenciales y el registro de stream— y dónde está el contrato técnico en la zona Developers.
Cuando quieres que contactos y eventos entren de forma programática y en tiempo real, usas la API de Ingesta de Instasent o una de las plataformas de webhooks. En esta página se explica qué hace el panel por ti —crea la fuente, muestra sus credenciales y transmite un registro de lo que llega— y dónde está el contrato técnico completo.
La API de Ingesta de Instasent
La API de Ingesta importa contactos y eventos con el formato propio de Instasent. Crearla como fuente de datos te da una pantalla de configuración con todo lo necesario para enviar datos:
Endpoint de contactosurl/v1/project/{uid}/datasource/{id}/stream/contacts — adonde envías los contactos.
Endpoint de eventosurl/v1/project/{uid}/datasource/{id}/stream/events — adonde envías los eventos.
UID de proyectostringEl identificador de tu proyecto, parte de cada URL de endpoint.
ID Fuente de datosstringEl identificador de esta fuente — cada fuente tiene el suyo.
Token secretostringEl token que autentica las llamadas a esta fuente. Cada fuente tiene el suyo.
La pantalla de configuración también lista los atributos aceptados y los eventos aceptados, y muestra un registro de stream de los datos entrantes para que confirmes que están llegando.
Forma del payload
Cada fuente recibe datos indexados por contacto. Un payload de contacto identifica al contacto; un payload de evento añade el nombre del evento y sus parámetros:
{ "contact_id": "..." }{ "contact_id": "...", "event": "...", "parameters": { } }Cada fuente de webhook y de API de Ingesta tiene su propio ID de fuente de datos y token secreto, así que puedes revocar o rotar una fuente sin afectar a las demás.
Plataformas de webhooks
Las plataformas de webhooks —Make, Zapier y las demás— son la vía sin código para llegar al mismo stream de ingesta. Usan las mismas credenciales por fuente que la API de Ingesta de arriba: en la página del conector, pulsa Instalar e Instasent crea la fuente y te muestra su UID de proyecto, Token secreto e ID Fuente de datos en Instrucciones de configuración — esas son las credenciales que llevas a la plataforma. (Es lo que la guía de conectores llama una plataforma de webhooks.) Construyes un escenario o un zap en la plataforma que envíe datos al endpoint de stream de tu fuente, de modo que puedes conectar Instasent con herramientas que no tienen conector nativo. Cada una tiene su página de conector con los pasos exactos:
Envía datos desde un escenario de Make al stream de ingesta.
ZapierEnvía datos desde un Zap al stream de ingesta.
Hasta dónde llega el panel y dónde empieza Developers
Esta página trata del lado del panel: crear la fuente, leer sus credenciales y la forma del payload, y ver el registro de stream. El contrato técnico completo —los esquemas de petición y respuesta, todos los campos aceptados, el manejo de errores— está en la zona Developers:
Cuando necesites integrar a nivel de código, sigue la guía de Developers; vuelve aquí para crear la fuente y leer sus credenciales.