Usar la API con una clave API
Utilice sus bots desde su propio software, una intranet o una aplicación. Cree una clave API en el portal y elija qué bots y datos puede utilizar.
Con la API, puede utilizar sus bots desde su propio software: una intranet, una aplicación o un CRM. Puede hacer preguntas a un bot, recuperar leads o ajustar el contenido sin abrir el portal.
¿Qué puede hacer con la API?
- Consultar sus bots y hacer una pregunta a un bot, también con streaming. Puede recuperar y continuar una conversación.
- Con Acceso a leads: recuperar leads, quejas y reportes de errores, ajustar el seguimiento, consultar reservas y reservar directamente, listar conversaciones y configurar webhooks.
- Con Gestionar contenido: ajustar formularios de oferta, reservas (incluyendo días de cierre), FAQ y fuentes.
- Con Puede crear bots: crear nuevos bots. Cada bot tiene su propio plan, por lo que un bot adicional tiene un coste. El solicitante debe confirmar ese precio.
- Consultar cifras y estadísticas de un bot.
Todas las llamadas, con ejemplos en curl, JavaScript y Python, están en la documentación de la API.
Crear una clave API
- Vaya al menú Conexiones → Claves API.
- Haga clic en Nueva clave.
- Asigne un Nombre para saber más adelante para qué sirve la clave.
- Elija Acceso a todos los bots (incluyendo los que añada más tarde) o desactívelo y seleccione los bots en Bots.
- Active lo que la clave puede hacer además: Puede crear bots, Acceso a leads y Gestionar contenido. Por defecto, todo está desactivado.
- Haga clic en Crear.
- Copie la clave de inmediato y guárdala de forma segura. No podrá verla después. En Pruébelo hay una primera llamada para probar.
Gestionar claves
En la lista, verá por clave el acceso, cuándo se usó por Último uso y quién la creó. Con Editar puede ajustar el nombre, los bots y los permisos. Con Revocar desactiva una clave de inmediato. Las aplicaciones que la utilicen ya no tendrán acceso, y los webhooks creados con ella se eliminarán. Esto no se puede deshacer.
Es bueno saber
- Solo el administrador de la cuenta (rol Administrador) puede crear y gestionar claves API. Consulte Equipo.
- Asigne a una clave solo los permisos que necesite. Con Acceso a leads, el software puede leer los datos de contacto de los visitantes.
- ¿Se ha filtrado una clave? Revóquela y cree una nueva.
- ¿Quiere enviar leads de inmediato sin tener que solicitarlos? Use webhooks.
- ¿Quiere usar sus bots en ChatGPT o Claude? No necesita una clave. Consulte MCP.