🔌 Avanzado y Beta > Endpoints externos¶

La funcionalidad Endpoints externos permite configurar integraciones HTTP para que Kewbot interactúe con APIs de terceros (CRM, ERP, scoring, validaciones, automatizaciones, etc.).

Con esta página puedes definir cómo Kewbot envía datos, recibe respuestas y decide el siguiente paso dentro de un flujo.

Nota: algunos campos pueden variar según versión del entorno, permisos y módulos habilitados.

Placeholder - Endpoints externos

¿Cuándo se usa?¶

Para consultar datos de cliente antes de enrutar o responder.
Para registrar eventos de conversación en sistemas externos.
Para disparar automatizaciones fuera de Kewbot.
Para enriquecer decisiones en ITRs/condiciones con información externa.

Vista de listado de endpoints¶

Campo / columna	Qué muestra	Para qué sirve
Nombre	Nombre interno del endpoint.	Identificación rápida dentro de flujos.
Descripción	Resumen funcional del endpoint.	Entender propósito sin abrir el detalle.
Estado	Activo/Inactivo.	Controlar disponibilidad operativa.
Método	GET, POST, PUT, PATCH, DELETE (según configuración).	Validar semántica de integración.
URL objetivo	Host/ruta principal configurada.	Verificar destino de llamadas.
Última ejecución	Fecha/hora de último uso.	Confirmar uso reciente.
Resultado último intento	Éxito o error más reciente.	Detección temprana de fallos.

Formulario de alta/edición de endpoint¶

Placeholder - Endpoints externos

Identificación y alcance¶

Campo	Qué significa
Nombre	Identificador funcional del endpoint en Kewbot.
Código / key interna	Clave técnica para referenciarlo desde flujos o reglas.
Descripción	Objetivo de negocio/técnico de la integración.
Activo	Habilita o bloquea su ejecución sin borrarlo.

Configuración de conexión¶

Campo	Qué significa
Método HTTP	Tipo de operación contra API externa.
URL base	Dominio/servidor principal del servicio externo.
Path / recurso	Ruta específica del recurso a invocar.
Query params	Parámetros de URL que se envían en la consulta.
Timeout (ms/seg)	Tiempo máximo de espera antes de cortar la llamada.
Reintentos	Número de intentos adicionales ante error o timeout.

Seguridad y autenticación¶

Campo	Qué significa
Tipo de autenticación	Modo de auth (None, API Key, Bearer, Basic, etc.).
API Key / Token / Usuario / Password	Credenciales según tipo de autenticación elegido.
Header de autorización	Nombre/valor del header para autenticar requests.
Headers personalizados	Pares clave-valor adicionales requeridos por la API.

Request (payload de salida)¶

Campo	Qué significa
Content-Type	Formato del body (JSON, form, etc.).
Body template	Plantilla de payload enviada al endpoint.
Variables disponibles	Campos de conversación/contacto que se pueden inyectar.
Mapeo de campos de salida	Relación entre datos de Kewbot y estructura requerida por API externa.

Response (procesamiento de entrada)¶

Campo	Qué significa
Código esperado (2xx/...)	Criterio para considerar la ejecución exitosa.
Mapeo de respuesta	Extracción de campos relevantes del response externo.
Guardar en variable	Persistencia de valores para uso en pasos posteriores del flujo.
Acción en error	Comportamiento cuando API responde error o timeout.
Mensaje/log de error	Texto o traza registrada para diagnóstico.

Prueba y validación del endpoint¶

En la pantalla de endpoint suele existir una opción de probar configuración.

Campo / control	Para qué sirve
Datos de prueba	Simular variables de una conversación real.
Ejecutar test	Lanzar llamada manual para validar configuración.
Status HTTP	Confirmar respuesta técnica del servidor externo.
Response body	Revisar contenido devuelto por API.
Tiempo de respuesta	Medir latencia de la integración.
Log técnico	Detectar errores de auth, formato o mapeo.

Recomendaciones de implementación¶

Usar credenciales seguras y rotación periódica.
Mantener timeouts y reintentos acotados para no bloquear flujos.
Versionar cambios de payload/mapeo con control de pruebas.
Definir estrategia de fallback cuando la API externa no esté disponible.
Auditar logs de error y tasa de éxito regularmente.