> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trybrein.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integraciones

> Conecta las herramientas donde ya llegan tus clientes. Cada aviso se vuelve un Contacto, su Empresa y, si quieres, una Oportunidad.

Una **Integración** es una herramienta de afuera conectada a tu espacio. La herramienta avisa a Brein cuando pasa algo: alguien agenda una reunión, paga, llena un formulario o se registra. Brein recibe el aviso, reconoce a la persona y crea su **Contacto** y su **Empresa**. Si quieres, también abre una **Oportunidad** en el Pipeline y la etapa que elijas.

No hay que programar. Copias una dirección, la pegas en la herramienta y listo. Si tu herramienta no está en la lista, conéctala como [Otra herramienta](/es/integraciones/otra-herramienta).

Las Integraciones viven en **Ajustes → Integraciones**. Solo el dueño o un admin del espacio puede conectarlas y confirmar cómo se leen sus avisos.

## Herramientas con plantilla

Una plantilla ya sabe cómo verificar los avisos de la herramienta y qué campos leer.

| Herramienta | Qué aviso usa Brein | Guía |
| - | - | - |
| Cal.com | Una reserva nueva | [Cal.com](/es/integraciones/calcom) |
| Calendly | Un invitado nuevo | [Calendly](/es/integraciones/calendly) |
| Stripe | Un pago completado o una factura pagada | [Stripe](/es/integraciones/stripe) |
| Tally | Una respuesta de formulario | [Tally](/es/integraciones/tally) |
| Typeform | Una respuesta de formulario | [Typeform](/es/integraciones/typeform) |
| Jotform | Una respuesta de formulario | [Jotform](/es/integraciones/jotform) |
| Webflow | Un formulario enviado en tu sitio | [Webflow](/es/integraciones/webflow) |
| Shopify | Un cliente nuevo | [Shopify](/es/integraciones/shopify) |
| Hotmart | Una compra aprobada | [Hotmart](/es/integraciones/hotmart) |
| Clerk | Un usuario nuevo | [Clerk](/es/integraciones/clerk) |
| PostHog | Un evento de una persona identificada | [PostHog](/es/integraciones/posthog) |

## Otra herramienta

Cualquier herramienta que sepa mandar un webhook entra. Brein te da una dirección secreta, esperas el primer aviso real, Brein propone qué campo es cada cosa y tú confirmas. La guía paso a paso está en [Otra herramienta](/es/integraciones/otra-herramienta).

## Qué le pasa a cada aviso

Cada aviso que entra es una **Llegada**. Se guarda tal como llegó y termina en uno de estos resultados. Los ves en la página de la Integración.

| Resultado | Qué significa | Qué hacer |
| - | - | - |
| **Aceptada** | Llegó al CRM: Contacto, su Empresa y, si lo pediste, una Oportunidad. | Nada. |
| **Duplicada** | Brein ya tenía ese mismo aviso, por su id o por su contenido. No se crea otra Llegada ni se cambia nada. | Nada. Es normal: las herramientas reintentan. |
| **Sin persona** | El aviso no trae correo, teléfono ni LinkedIn, o el correo es de los que no cuentan (ver abajo). No hay a quién crear. | Revisa si el campo existe en el aviso. Si lo mandas en otro campo, corrige el mapeo y reprocésala. |
| **No entendida** | El aviso no se parece a lo que el mapeo espera, o la Integración todavía no tiene mapeo. | Confirma o corrige el mapeo y reprocésala. |
| **Por decidir** | El correo es de un Contacto y el teléfono es de otro. Brein no adivina. | Una persona elige a cuál va. |
| **Fallida** | Brein intentó aplicarla cinco veces y no pudo. | Reprocésala. Si vuelve a fallar, avísanos. |

Una firma que no coincide se rechaza y queda anotada, sin crear nada. Un tipo de aviso que la Integración no usa, por ejemplo una reserva cancelada, se recibe y se ignora, sin error y sin Llegada.

## Cómo reconoce Brein a una persona

1. Primero por **correo**. Si ya hay un Contacto con ese correo, Brein completa lo que le falte y no lo duplica.
2. Si no hay correo, por **teléfono**.
3. El LinkedIn se guarda en el Contacto, pero todavía no sirve para reconocer a nadie.

Hay valores que no cuentan, porque no identifican a una persona:

* Correos de prueba o de buzón general: `test@`, `info@`, `contacto@`, `hola@`, `ventas@`, `admin@`, `soporte@`, `noreply@` y parecidos. También `example.com` y `test.com`. Un `test+1@` cuenta como `test@`.
* Los correos de dominios gratis (`gmail.com`, `hotmail.com`, `outlook.com`, `yahoo.com` y similares) sí crean el Contacto, pero **no crean Empresa**, porque el dominio es del proveedor y no de la empresa de la persona.

## Qué guarda Brein

* **Lo que ignoras no se guarda.** Cada campo del aviso va a un campo del Contacto, a uno de la Empresa, a **solo en la historia** o a **ignorar**. Lo que mandas a ignorar no entra al Contacto. Un campo que aparece después y que nadie decidió se queda como **campo nuevo sin decidir** y tampoco se guarda hasta que lo decidas.
* **El aviso crudo se borra a los 30 días.** Pasa lo mismo con el ejemplo de la primera vez. Quedan la Llegada, su resultado, el Contacto y su recorrido. Sin el aviso crudo ya no hay de dónde reprocesar. Las Llegadas que siguen esperando (en cola o por decidir) conservan el suyo hasta que se resuelvan.

## Reprocesar

Si una Llegada quedó **sin persona** o **no entendida**, corrige el mapeo en la página de la Integración y usa **Reprocesar**. Puedes reprocesar una sola o todas las de esa Integración. Brein las lee otra vez con el mapeo de hoy:

* Las que ahora traen a una persona vuelven a la cola y se aplican.
* Las que siguen sin persona cambian de resultado o se quedan como estaban.
* Las que ya cumplieron 30 días no se pueden reprocesar, porque su aviso crudo ya se borró.

Una Llegada **fallida** también se reprocesa desde la Integración. Desde tu agente, `arrival_read` las muestra y `arrival_propose_reprocess` prepara el reproceso de una fallida, que se aplica solo con tu sí.

## Para desarrolladores

La puerta tiene su contrato. Ver [Enviar eventos a Brein](/es/api/door) para la ruta, la firma y los códigos de respuesta.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.