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

# Autenticación y credenciales en el webhook personalizado

> Conecta APIs externas con OAuth2, Basic auth, Bearer token o API key y guarda tus claves de forma segura y enmascarada.

La acción **Webhook personalizado** envía datos de tus flujos a cualquier API externa. La mayoría de esas APIs exigen autenticación, y Chateea te permite configurarla de forma segura: puedes usar **OAuth2** para conectar servicios como Google, Facebook o LinkedIn, o guardar credenciales de tipo **Basic auth**, **Bearer token** o **API key** que quedan ocultas y protegidas.

## Métodos de autenticación disponibles

| Método | Cuándo usarlo |
| - | - |
| **OAuth2** | APIs grandes que usan este estándar de autorización, como las de Google, Facebook o LinkedIn. Es el método más seguro para este tipo de servicios. |
| **Basic auth** | APIs que piden usuario y contraseña. |
| **Bearer token** | APIs que piden un token de acceso en la cabecera. |
| **API key** | APIs que piden una clave de API. |

## Usar OAuth2

**1. Agrega la acción**

En tu flujo, agrega la acción **Webhook personalizado**.

**2. Elige OAuth2**

En el tipo de autorización, selecciona **OAuth2**.

**3. Selecciona o solicita un token**

Elige un token que ya tengas guardado o solicita uno nuevo siguiendo el proceso de autorización del servicio.

### Gestionar los tokens de OAuth2

1. Ve a **Automatización → Flujos de trabajo** y abre **Configuración global de flujos de trabajo**.
2. En la sección **Gestionar tokens**, haz clic en **Gestionar token**.
3. Se abre una ventana con la lista de todos tus tokens. Desde ahí puedes **actualizarlos** o **eliminarlos**.

## Usar Basic auth, Bearer token o API key

Las claves secretas de estos métodos se guardan cifradas y se muestran enmascaradas en la interfaz. Nunca aparecen en texto plano, así que no se filtran por accidente en una captura de pantalla o al compartir un flujo. Cada clave se identifica por un nombre, no por su valor.

**1. Agrega la acción**

En tu flujo, agrega la acción **Webhook personalizado**.

**2. Elige el tipo de autenticación**

Selecciona **Basic auth**, **Bearer token** o **API key**.

**3. Crea la clave**

Elige **Crear nueva clave**. Escribe un **nombre** para identificarla y el **valor** (la credencial real). Al guardarla, el valor queda enmascarado.

**4. Reutiliza o gestiona tus claves**

En otros webhooks, elige la clave guardada desde el menú desplegable. Desde ese mismo menú puedes eliminar claves que ya no uses.

## Seguridad y permisos

* **Solo en tu cuenta:** las claves solo están disponibles dentro de la cuenta de Chateea donde se crearon.
* **Quién puede eliminarlas:** solo los administradores de la cuenta o la persona que creó la clave.
* **Reemplazo automático:** cuando actualizas una clave por una nueva, la anterior se elimina automáticamente.

> [!TIP]
>
> Usa nombres descriptivos para tus claves, por ejemplo "API facturación producción", y crea claves distintas para pruebas y producción. Así evitas enviar datos reales a un entorno de pruebas.

> [!NOTE]
>
> El Webhook personalizado es una acción premium. Consulta [Acciones premium y planes de ejecuciones](https://help.chateea.com/docs/automatizaciones/acciones-premium-y-planes-de-ejecuciones.md) para saber cómo se cobra.

## Artículos relacionados

> **[Acciones premium y planes](https://help.chateea.com/docs/automatizaciones/acciones-premium-y-planes-de-ejecuciones.md)**
>
> Cómo se cobran las ejecuciones premium.

> **[Registros de ejecución](https://help.chateea.com/docs/automatizaciones/registros-de-ejecucion-e-historial-de-inscripcion.md)**
>
> Revisa la respuesta de cada webhook.


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