Plantillas de Credenciales
Una plantilla es como un formulario preimpreso que ya tiene rellenas las partes dificiles — tu solo firmas con tu nombre. Para conectar un servicio popular, una plantilla de credencial te entrega un formulario con los campos correctos ya preparados, asi te saltas la parte de averiguar la configuracion tecnica y simplemente agregas tu propia clave, pase o inicio de sesion.
Image: La pagina de plantillas de credenciales mostrando tarjetas de servicios organizadas por categoria
Antes de empezar
- La clave, el pase de acceso o los datos de cuenta del servicio que quieres conectar. (Para servicios de estilo de inicio de sesion, solo iniciaras sesion durante la configuracion — no hay nada que copiar de antemano.)
- Para servicios que usan el estilo "Iniciar sesion con…", la posibilidad de configurar una app conectada en la consola de desarrollador de ese servicio.
- Si no estas seguro de que necesita tu servicio, el Asistente IA de Credenciales puede averiguarlo por ti.
Encuentra una plantilla
- Abre Credenciales desde la barra lateral.
- Haz clic en "+ New Credential".
- Explora la biblioteca de plantillas.
Las plantillas estan agrupadas por categoria para que encuentres lo que necesitas rapidamente:
| Categoria | Servicios | Tipo de conexion |
|---|---|---|
| Comunicacion | Gmail, Outlook, Slack | OAuth |
| CRM y Ventas | HubSpot, GoHighLevel | OAuth |
| IA y Desarrollo | OpenAI, Anthropic, GitHub | API key / Bearer / OAuth |
| E-commerce | Shopify, WooCommerce | OAuth / Basic |
| Productividad | Google Calendar, Google Sheets, Notion | OAuth / Bearer |
| Plataformas Meta | WhatsApp, Instagram, Messenger, Meta Ads | Inicio de sesion con Facebook |
Si el servicio que necesitas no esta en la biblioteca, usa el Asistente IA de Credenciales — puede investigar cualquier proveedor y configurar la conexion por ti.
Usa una plantilla
- Haz clic en la tarjeta del servicio que quieres conectar.
- Completa los campos requeridos — el formulario te indica exactamente que se necesita.
- Si es una plantilla "Iniciar sesion con…", ademas:
- Configura una app conectada en la consola de desarrollador del proveedor.
- Copia la URL de redireccion de Nirvai y agregala a esa app.
- Haz clic en Authorize para finalizar la conexion.
- Haz clic en Save.
Image: Completando un formulario de plantilla de credencial con los campos requeridos resaltados
Que completa la plantilla por ti
La plantilla ya conoce los detalles tecnicos de cada servicio, asi que tu solo aportas tus propios datos privados.
| La plantilla provee | Tu aportas |
|---|---|
| El tipo de conexion (API key, inicio de sesion, etc.) | Tu clave, pase de acceso o secreto |
| Los nombres de los campos y donde va cada valor | El ID de tu cuenta (para servicios de inicio de sesion) |
| Las direcciones de inicio de sesion y de segundo plano (para servicios de inicio de sesion) | Tu usuario/contrasena (para el tipo basic) |
| Los permisos recomendados (para servicios de inicio de sesion) | — |
Elige la plantilla correcta
Si un servicio ofrece mas de una forma de conectarse, usa esto para decidir.
| Elige… | Cuando… |
|---|---|
| Una plantilla de API key / pase de acceso | Solo necesitas usar las funciones del servicio (como generar texto con OpenAI), te da un solo codigo en su panel, y no necesitas llegar a la cuenta de una persona especifica |
| Una plantilla "Iniciar sesion con…" (OAuth) | Necesitas llegar a los datos de una persona especifica (como leer su Gmail), el servicio requiere un paso de inicio de sesion, o quieres un control detallado de lo que tu agente puede hacer |
| Una plantilla de Plataforma Meta | Estas conectando WhatsApp, Instagram, Messenger o Meta Ads — consulta Credenciales de Plataformas Meta |
No hay plantilla para tu servicio?
Si no ves una plantilla, tienes dos opciones:
Opcion A — Asistente IA de Credenciales (Recomendado)
Describe el servicio que quieres conectar, y la IA lo investiga, escoge el tipo de conexion correcto y te guia en la configuracion. Ideal para casi todos, ya que hace el razonamiento tecnico por ti. Consulta Asistente IA de Credenciales.
Opcion B — Configurarla a mano
Elige un tipo de conexion tu mismo y completa cada campo. Ideal cuando conectas un servicio interno y ya conoces sus detalles tecnicos.
- Abre Credenciales → "+ New Credential".
- Desplazate hasta el fondo y elige un tipo de conexion — API key, Bearer, OAuth o Basic.
- Completa todos los campos.
- Haz clic en Save.
La configuracion manual es ideal para servicios internos donde ya conoces los datos de inicio de sesion. Para todo lo demas, el Asistente IA es mas rapido y mas dificil de equivocar.
Solucion de problemas
| Problema | Solucion |
|---|---|
| El servicio que quieres no esta en la biblioteca de plantillas | Usa el Asistente IA de Credenciales — puede configurar cualquier proveedor, incluso los que no tienen plantilla |
| El inicio de sesion falla en una plantilla "Iniciar sesion con…" | Asegurate de que la URL de redireccion en tu app conectada coincida exactamente con la de Nirvai, sin caracteres extra ni barra al final |
| Guardaste la conexion pero el agente aun no puede actuar | Confirma que pegaste la clave o el pase correcto, y que vinculaste la conexion a la herramienta — consulta Usar Credenciales con Herramientas |
| No estas seguro de que plantilla elegir para un servicio con varias | Sigue la guia Como elegir, o deja que el Asistente IA decida |
Que sigue
Despues de guardar una conexion, continua con Usar Credenciales con Herramientas para vincularla a tu agente.