POST: tu backend, un flujo de Zapier, n8n o Make, o una herramienta con su propio aviso.
Brein lee el primer aviso real, propone qué campo es cada cosa y tú confirmas. Todo se hace en Ajustes → Integraciones. Solo el dueño o un admin del espacio puede conectar y confirmar el mapeo.
1
Crea la Integración
En Ajustes → Integraciones, elige Conectar → Otra herramienta, ponle un nombre y, si quieres que cada aviso abra una Oportunidad, elige el Pipeline y la etapa.
2
Copia la dirección secreta
Brein te da una dirección con esta forma:El token es la contraseña de la Integración. Se muestra una sola vez. Brein guarda solo una huella del token, así que no puede mostrártelo de nuevo. Guárdalo como cualquier secreto.
3
Manda el primer aviso real
Pega la dirección en tu herramienta y provoca un aviso de verdad: un registro, un pago, una respuesta. O prueba con Brein responde
curl:202 con el id de la Llegada y el estado unmapped: todavía no hay mapeo, así que el aviso se guarda como ejemplo y no se crea ningún Contacto.4
Revisa lo que detectó Brein
En la página de la Integración ves el ejemplo con cada campo y lo que Brein propone para él. La detección usa reglas, sin IA:
- El correo por su forma (
algo@dominio.mx) y el LinkedIn por su dirección. - El teléfono si empieza con
+y tiene de 7 a 15 dígitos, o si el nombre del campo lo dice (telefono,phone,celular,whatsapp). - El nombre, la empresa, el puesto y el sitio por el nombre del campo, en español o en inglés (
nombre,name,empresa,company,cargo,role,sitio,website). Un nombre y un apellido del mismo bloque se unen en ese orden. - El id del aviso (
id,event_id,uuid…) y el tipo de evento (type,event,topic…): no van al Contacto, sirven para no duplicar y para distinguir avisos. - Los campos de quien organiza o administra, o de un producto, un plan o un formulario, no se toman como la persona.
5
Elige el correo del cliente
Si el aviso trae más de un correo, o más de un teléfono, Brein te lo marca y tú eliges cuál es el del cliente. Los demás se ignoran.
6
Decide a dónde va cada campo y confirma
Cada campo puede ir a:
El mapeo necesita al menos un campo de correo, teléfono o LinkedIn. Al confirmar, el mapeo queda fijo y con número de versión. Cada cambio sube la versión.
Avisos en lote
Algunas herramientas mandan varias personas en un solo aviso, por ejemplo{ "items": [ … ] } o una lista al nivel de arriba. Brein reconoce las listas que se llaman data, events, items, records, results, entries o rows. Cada elemento de la lista se vuelve su propia Llegada, con su propio resultado. Un elemento que falla no detiene a los demás. La respuesta trae una lista con el resultado de cada uno.
Campos nuevos
El mapeo es fijo. Si un día el aviso trae un campo que no estaba en el ejemplo, Brein no lo guarda: lo muestra como campo nuevo sin decidir. Elige a dónde va, o ignóralo, y desaparece de la lista. Hasta entonces, ese campo no entra al Contacto. Se guardan hasta 200 campos nuevos por Integración.Cambiar el mapeo y reprocesar
Puedes corregir el mapeo cuando quieras en la página de la Integración. Cambiarlo no toca lo que ya se aceptó. Para las Llegadas que quedaron sin persona o no entendidas:- Corrige el mapeo.
- Elige Reprocesar, en una Llegada o en todas las de la Integración.
Rotar la dirección
Si la dirección se filtró, o alguien que la tenía ya no debe tenerla, usa Rotar. Brein crea una dirección nueva y se muestra una sola vez. La anterior deja de servir al instante: actualiza tu herramienta antes de que mande el siguiente aviso, o llegará como rechazado.Límites
Si eres desarrollador y quieres firmar tus envíos, el contrato firmado está en Enviar eventos a Brein.
Qué pasa con cada Llegada, cómo se reconoce a una persona y qué se guarda: Integraciones.