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

# Calendly

> Cada invitado nuevo en Calendly crea su Contacto y su Empresa.

## Qué trae a Brein

Cada vez que alguien agenda con tu Calendly, Brein crea o completa su **Contacto** y su **Empresa** (por el dominio de su correo de trabajo). Si lo pides al conectar, también abre una **Oportunidad**.

| De Calendly | Va a |
| - | - |
| Nombre del invitado | Nombre del Contacto |
| Correo del invitado | Correo del Contacto |
| Número para recordatorios por texto | Teléfono del Contacto |
| Preguntas y respuestas del formulario de agenda | Solo en la historia |

## Conéctala

Calendly no tiene pantalla para crear webhooks: se crean con su API. Necesitas un token de acceso de Calendly con permiso para leer eventos agendados.

<Steps>
  <Step title="En Brein">
    Ve a **Ajustes → Integraciones → Conectar → Calendly**. Copia la **dirección** y el **secreto**. El secreto se ve una sola vez.
  </Step>

  <Step title="Crea el webhook en Calendly">
    Con la API de Calendly (*Create Webhook Subscription*), manda una petición `POST` a `https://api.calendly.com/webhook_subscriptions`:

    ```bash theme={"theme":"github-light"}
    curl -X POST "https://api.calendly.com/webhook_subscriptions" \
      -H "Authorization: Bearer $CALENDLY_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "url": "https://api.trybrein.com/api/v1/door/<id de la Fuente>",
        "events": ["invitee.created"],
        "organization": "https://api.calendly.com/organizations/<tu organización>",
        "scope": "organization",
        "signing_key": "<el secreto de Brein>"
      }'
    ```

    En `signing_key` va el secreto que copiaste de Brein. Así Calendly firma cada aviso y Brein lo verifica.
  </Step>

  <Step title="Prueba">
    Agenda una reunión de prueba. En Brein verás la Llegada.
  </Step>
</Steps>

## Qué eventos elegir

Solo `invitee.created`, que es cuando alguien agenda. Brein ignora los demás.

## Límites

* Calendly crea los webhooks solo por API, y el secreto de Brein se pone como `signing_key` al crearlo. Si el webhook ya existe sin esa clave, bórralo y créalo de nuevo.
* Una reunión cancelada no cambia nada en el Contacto.

Más sobre resultados, reconocimiento de personas y privacidad: [Integraciones](/es/integraciones). Fuente: [firmas de webhook de Calendly](https://developer.calendly.com/api-docs/overview/webhooks/webhook-signatures).


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