# 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.

**Language:** es
**Audience:** platform
**Translation key:** platform.data-sources.api-webhooks
**Search keywords:** api, api de ingesta, webhook, webhooks, stream, token secreto, project uid, id de fuente de datos, endpoint de contactos, endpoint de eventos, tiempo real, enviar datos, Make, Zapier, importación programática
**Related pages:** /platform/en/data-sources/api-webhooks, /platform/es/data-sources, /platform/es/data-sources/connectors, /platform/es/data-sources/connectors/make, /platform/es/data-sources/connectors/zapier
**Docs index (every page):** https://docs.instasent.com/llms.txt
**This zone's index:** https://docs.instasent.com/platform/es/llms.txt
**This page:** https://docs.instasent.com/platform/es/data-sources/api-webhooks/ (HTML) · https://docs.instasent.com/platform/es/data-sources/api-webhooks.md (Markdown)
**Other language (en):** https://docs.instasent.com/platform/en/data-sources/api-webhooks.md

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 contactos` — `url`
  `/v1/project/{uid}/datasource/{id}/stream/contacts` — adonde envías los contactos.
- `Endpoint de eventos` — `url`
  `/v1/project/{uid}/datasource/{id}/stream/events` — adonde envías los eventos.
- `UID de proyecto` — `string`
  El identificador de tu proyecto, parte de cada URL de endpoint.
- `ID Fuente de datos` — `string`
  El identificador de esta fuente — cada fuente tiene el suyo.
- `Token secreto` — `string`
  El 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.

{/* CAPTURE-SECURITY (Héctor, audit 2026-07): esta captura muestra el Token secreto REAL. Re-capturarla genericando el token (reemplazar en el DOM por un valor tipo `ist_••••••••` antes del screenshot). Regla general: auditar toda captura/Properties por fugas de credenciales/tokens. Los datos demo de contacto (cuenta Acme) NO se enmascaran; credenciales/tokens SÍ. */}

![La pantalla de configuración de la fuente de la API de Ingesta con los endpoints de contactos y eventos, el UID de proyecto, el ID Fuente de datos y el Token secreto](/platform/es/data-sources/images/api-webhooks--1-ingest-credentials.png)
*La pantalla de Instrucciones de configuración: los endpoints de contactos y eventos, el UID de proyecto, el ID Fuente de datos y el Token secreto, además de los atributos y eventos aceptados.*

## 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:

```json
{ "contact_id": "..." }
```

```json
{ "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 {conector}** 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](/platform/es/data-sources/connectors#plataformas-de-webhooks-te-damos-las-credenciales).)
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:

- [Make](/platform/es/data-sources/connectors/make) - Envía datos desde un escenario de Make al stream de ingesta.
- [Zapier](/platform/es/data-sources/connectors/zapier) - Enví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:

- [Guía de la API de Ingesta](https://staging-instasent-docs-nextjs.oscar-284.workers.dev/developers/ingest-api/guide) - La referencia completa de la API de Ingesta y el Swagger para contactos y eventos a gran volumen.

Cuando necesites integrar a nivel de código, sigue la guía de Developers; vuelve aquí
para crear la fuente y leer sus credenciales.

---

This is one page of the Instasent documentation. For the complete machine-readable index of every guide and API reference, fetch https://docs.instasent.com/llms.txt — start there for full context.