Tu chatbot Chatbotty ya responde preguntas en tu sitio web a través de su widget. Pero, ¿qué pasaría si quisieras que tu chatbot de IA también estuviera en otro lugar, como dentro de tu propia aplicación móvil, un portal de clientes o una herramienta interna que tu equipo usa todos los días? Para eso sirve exactamente una **API**. Esta guía explica qué es una API en lenguaje sencillo, cómo funciona la API de Chatbotty, qué puedes construir con ella y cómo crear tu primera clave API. No se requiere título en informática, solo una idea clara de cómo encajan las piezas. Este es el primer artículo de una serie. Aquí cubrimos la visión general; los artículos posteriores profundizan en cada parte de la API en detalle. ## ¿Qué es exactamente una API? API significa *Interfaz de Programación de Aplicaciones*. Suena técnico, pero la idea es simple: una API es una forma para que dos programas de software se comuniquen directamente, sin que un humano tenga que hacer clic en botones entre medio. Piénsalo como pedir en un restaurante. No entras a la cocina a cocinar tu propia comida. Le dices al camarero lo que quieres, el camarero pasa tu pedido a la cocina y la comida vuelve a tu mesa. El camarero es la API: un mensajero que toma tu solicitud, la entrega al sistema que hace el trabajo y trae la respuesta. Con Chatbotty, la "cocina" es tu chatbot de IA y su base de conocimientos. La API es el mensajero con el que habla tu software. Tu aplicación envía una pregunta, el chatbot encuentra la respuesta y la API envía esa respuesta directamente a tu aplicación, todo en una fracción de segundo. ## ¿Por qué conectar tu chatbot a una API? El widget de chat es perfecto para tu sitio web. Pero una API abre todo lo demás: - **Construye un chatbot dentro de tu propia app.** Pon tu asistente de IA dentro de una aplicación móvil o una app web personalizada, con tu propio diseño alrededor. - **Conecta tu chatbot con otras herramientas.** Alimenta respuestas a un centro de ayuda, un canal de Slack o un panel interno. - **Automatiza tu base de conocimientos.** Sube nuevos documentos a tu chatbot automáticamente cada vez que cambie la información de tu producto. - **Extrae tus propios informes.** Lee el historial de conversaciones y análisis en tus sistemas en lugar de revisar el panel manualmente. En resumen: el widget es la puerta principal lista para usar, y la API es el juego de llaves que te permite construir tus propias puertas donde las necesites. ## Qué puedes hacer con la API de Chatbotty La API de Chatbotty está organizada en cinco áreas. Encontrarás ejemplos de código listos para copiar para cada una directamente en tu panel, bajo **Integración API**. - **API de Chat** — envía un mensaje a tu chatbot y recibe la respuesta de la IA, el mismo motor que impulsa tu widget. - **API de Documentos** — sube, lista y elimina los documentos que conforman la base de conocimientos de tu chatbot. - **API de Conversaciones** — lee conversaciones pasadas y sus mensajes. - **API de Análisis** — extrae estadísticas agregadas como total de preguntas y tasa de éxito. - **API de Tickets** — lista tickets de soporte, cambia su estado y añade notas internas. No te preocupes por los detalles todavía. Cada una tendrá su propio artículo dedicado. Por ahora, solo sabe que casi todo lo que ves en el panel también puedes accederlo mediante la API. ## Cómo las claves API mantienen seguro tu chatbot El software no puede iniciar sesión con un correo y contraseña como tú. En cambio, se identifica con una **clave API** — una cadena larga y secreta de caracteres. Cada solicitud que envía tu app incluye esta clave para que Chatbotty sepa que la solicitud realmente viene de ti y a qué chatbot pertenece. La clave se envía en una parte de la solicitud llamada *cabecera Authorization*, como algo llamado **token Bearer**. No necesitas memorizar esos términos — los ejemplos de código en tu panel ya los incluyen. Solo reemplaza el marcador `YOUR_API_KEY` con tu clave real y listo. Una clave está vinculada a un chatbot específico. Nunca tienes que enviar un ID de chatbot — Chatbotty sabe cuál es por la clave misma. Una clave API es como una contraseña para tu chatbot. Cualquiera que la tenga puede hablar con tu chatbot y leer sus datos. Nunca la pegues en código público, en el front-end de un sitio web o en un documento compartido — mantenla en tu propio servidor seguro. ## Cómo crear tu primera clave API Crear una clave toma unos diez segundos. Aquí tienes todo el proceso. 1. Abre tu panel y ve a **Integración API** en el menú izquierdo. 2. Encuentra el chatbot que quieres conectar. Cada chatbot tiene su propia sección de **Claves API**. 3. Haz clic en **Crear nueva clave API**. 4. Ponle un nombre a la clave que reconozcas después, como *Sitio web de producción* o *App móvil*. El nombre es solo para ti — te ayuda a recordar dónde se usa cada clave. 5. Haz clic en **Crear**. Tu clave nueva aparece de inmediato. Copia tu clave ahora y guárdala en un lugar seguro. Por seguridad, la clave completa solo se muestra una vez. Después de cerrar esta ventana, el panel solo muestra los primeros caracteres. Si alguna vez la pierdes, simplemente elimina la clave antigua y crea una nueva. Puedes crear varias claves por chatbot — una forma práctica de dar a cada app su propia clave. Puedes desactivar una clave en cualquier momento sin eliminarla, o eliminarla definitivamente cuando ya no la necesites. ## Tu primera solicitud API Una vez que tienes una clave, hablar con tu chatbot es una solicitud simple. Aquí el ejemplo más pequeño posible usando cURL, una herramienta básica de línea de comandos: ```bash curl -X POST "https://www.chatbotty.ai/api/v1/chat" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"message": "¿Cuáles son tus horarios de apertura?"}' ``` Tu chatbot lee el mensaje, busca en su base de conocimientos y responde, exactamente como lo haría en el widget. La primera solicitud de chat también crea una *conversación*, y puedes pasar su ID en la siguiente solicitud para continuar la conversación con todo el contexto. ¿Prefieres JavaScript, Python o Node.js? Cada ejemplo en el panel está disponible en esos lenguajes también, listo para copiar. ## ¿Quién puede usar la API? La API de Chatbotty está disponible en los planes **Evaluación**, **Elite** y **Enterprise**. Si tu plan actual aún no incluye acceso a la API, la página de Integración API te mostrará las opciones de actualización. Las solicitudes de chat enviadas a través de la API cuentan para tu cuota mensual de mensajes, igual que los chats desde el widget — las otras áreas, como análisis y conversaciones, no consumen mensajes. ## ¿Listo para empezar a construir? Esa es toda la imagen: una API permite que tu propio software hable directamente con tu chatbot, una clave API mantiene segura esa conexión y el panel te entrega código funcional para cada parte. Abre la página de Integración API, crea tu primera clave y prueba una solicitud de chat — una vez que veas a tu chatbot responder a través de la API, todo lo demás encajará. Estate atento a los próximos artículos de esta serie, donde exploraremos las APIs de Chat, Documentos, Conversaciones, Análisis y Tickets una por una.