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

# Conecta aplicaciones (Google, Slack, HubSpot y más)

> Dales a tus agentes capacidades reales — consultar calendarios, actualizar tu CRM, publicar en Slack — en unos clics, sin código.

Las conexiones de aplicaciones permiten que un agente de voz actúe dentro de las herramientas que tu equipo ya usa durante una conversación: consultar la disponibilidad en un calendario, buscar a quien llama en tu CRM, agregar un prospecto a una hoja de cálculo, publicar un resumen en Slack. Conectas una cuenta una vez en **Conexiones → Aplicaciones** (`/dashboard/app-connections`), eliges lo que el agente puede hacer y adjuntas la conexión a cualquier agente en su constructor.

Actualmente hay seis aplicaciones disponibles:

| Aplicación          | Lo que tu agente puede hacer con ella                               |
| ------------------- | ------------------------------------------------------------------- |
| **Google Calendar** | Ver disponibilidad y administrar eventos del calendario.            |
| **Google Sheets**   | Agregar detalles de prospectos y resultados de llamadas a una hoja. |
| **Slack**           | Buscar canales, buscar mensajes y publicar con permiso.             |
| **HubSpot**         | Buscar contactos, actualizar registros y agregar notas.             |
| **Salesforce**      | Buscar registros, actualizar prospectos y registrar actividad.      |
| **Cal.com**         | Consultar disponibilidad y administrar reservas.                    |

Para cualquier elemento que no esté en esta lista, crea una [conexión de API](/es/guides/api-connections) personalizada o agrega un [servidor MCP](/es/guides/mcp-servers).

## Conecta una cuenta

<Steps>
  <Step title="Abre Conexiones → Aplicaciones y haz clic en Añadir aplicación">
    Un selector muestra las seis aplicaciones. Puedes conectar varias cuentas
    de la misma aplicación; cada una muestra un recuento de "conectadas" una vez que tienes una.
  </Step>

  <Step title="Autoriza la cuenta">
    La mayoría de las aplicaciones usan OAuth: se abre una ventana emergente, inicias sesión en el proveedor y
    apruebas el acceso, y la conexión aparece en la página. **Cal.com es
    la excepción**: se conecta con una clave de API. Pega la clave
    y haz clic en **Validar y conectar**; la clave se verifica con Cal.com
    antes de cifrarse y guardarse.
  </Step>

  <Step title="Solo Google Sheets: elige la hoja de cálculo">
    Una conexión de Sheets necesita saber en qué hoja de cálculo y pestaña debe
    escribir. Justo después de conectarla, se abre un panel de
    configuración: pega la URL de la hoja de cálculo (o su ID), haz clic en **Inspeccionar hoja de cálculo** y
    elige la pestaña. El panel confirma las columnas que encontró. Hasta que esto se
    complete, la tarjeta de conexión muestra **Necesita configuración**.
  </Step>
</Steps>

<Note>
  La verificación de OAuth de Google de ThunderPhone está actualmente en revisión, por lo que
  Google muestra una advertencia de "aplicación no verificada" durante el consentimiento para Google
  Calendar y Google Sheets. El diálogo **Añadir aplicación** te guía
  por los dos clics para continuar (**Opciones avanzadas → Ir a ThunderPhone**).
</Note>

Conectar y administrar conexiones de aplicaciones requiere el rol de **administrador** o **propietario**
en la organización.

## Controla lo que el agente puede hacer

Cada conexión tiene controles de permisos por operación; abre una tarjeta de conexión
para administrarlos. Las operaciones de lectura comienzan habilitadas; las operaciones que
escriben o modifican tus datos comienzan **desactivadas** hasta que las habilites:

| Aplicación      | Habilitado de forma predeterminada                                 | Desactivado de forma predeterminada                |
| --------------- | ------------------------------------------------------------------ | -------------------------------------------------- |
| Google Calendar | Ver eventos y disponibilidad, Crear eventos                        | Actualizar eventos, Cancelar eventos               |
| Google Sheets   | Agregar filas                                                      | —                                                  |
| Slack           | Ver canales y mensajes recientes, Buscar mensajes                  | Publicar mensajes                                  |
| HubSpot         | Buscar y leer contactos y empresas                                 | Crear o actualizar contactos y agregar notas       |
| Salesforce      | Buscar y leer prospectos, contactos y oportunidades                | Crear o actualizar registros y registrar actividad |
| Cal.com         | Listar tipos de eventos y consultar disponibilidad, Crear reservas | Reprogramar o cancelar reservas                    |

Una operación que deshabilitas simplemente no está disponible para el agente: las
herramientas correspondientes nunca se le ofrecen en las llamadas.

## Las herramientas que obtiene tu agente

Una vez que una conexión se adjunta a un agente, las operaciones habilitadas aparecen
como herramientas invocables durante las conversaciones:

* **Google Calendar** — `calendar_list_events`, `calendar_check_availability`,
  `calendar_create_event`, `calendar_update_event`, `calendar_cancel_event`
* **Google Sheets** — `sheets_append_row` (escribe en la hoja de cálculo y la pestaña
  que configuraste)
* **Slack** — `slack_list_channels`, `slack_search_messages`,
  `slack_post_message`
* **HubSpot** — `hubspot_search_contacts`, `hubspot_get_contact`,
  `hubspot_upsert_contact`, `hubspot_add_note`
* **Salesforce** — `salesforce_search_records`, `salesforce_get_record`,
  `salesforce_upsert_lead`, `salesforce_log_activity`
* **Cal.com** — `calcom_list_event_types`, `calcom_check_availability`,
  `calcom_create_booking`, `calcom_cancel_booking`

No necesitas escribir esquemas para ninguna de estas herramientas: ThunderPhone define las herramientas
y enruta las llamadas a través de la cuenta conectada.

## Adjunta la conexión a un agente

Las conexiones no hacen nada hasta que un agente las usa. Abre el agente en el
constructor ([Crear un agente](/es/guides/build-an-agent)) y agrega la conexión
en su sección **Apps conectadas**. La tarjeta de una conexión en la página Apps
muestra cuántas operaciones están habilitadas y cuántos agentes la usan.

## Desconectar

Abre una tarjeta de conexión y desconéctala desde allí. Los agentes que la estaban
usando perderán esas herramientas en su próxima llamada.

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Convierte cualquier API en una acción de agente" icon="plug" href="/es/guides/api-connections">
    El asistente para pegar cURL para servicios sin una conexión nativa.
  </Card>

  <Card title="Agrega un servidor MCP" icon="server" href="/es/guides/mcp-servers">
    Usa tu propio servidor de herramientas mediante Streamable HTTP.
  </Card>
</CardGroup>
