Qué es un conector

Una llamada HTTP a TU back-office que el agente puede hacer cuando hace falta: consultar un pedido, cambiar una cita, abrir una devolución.

No hay plantillas por proveedor ni integraciones «oficiales» con nadie. Describes tu API y ya está: cualquier API que hable HTTP y JSON encaja, incluida la que escribió tu equipo el año pasado.

1. Describe la llamada

Nombre, descripción, método y URL. En la URL puedes poner variables entre llaves, que se sustituyen con los argumentos.

La descripción no es decorativa: es lo que lee el modelo para decidir cuándo usarlo. «Consulta el estado de un pedido por su número» funciona; «endpoint de pedidos» no.

2. Declara los argumentos

Un subconjunto de JSON Schema: objeto con propiedades de tipos simples, listas de valores y campos obligatorios. Lo que no esté declarado se descarta antes de salir.

{
  "type": "object",
  "properties": {
    "numero_de_pedido": { "type": "string" },
    "motivo": { "type": "string", "enum": ["defectuoso", "no_es_lo_que_pedi", "tarde"] }
  },
  "required": ["numero_de_pedido"]
}

3. Lo que NO declaras

Quién es el cliente y de qué organización no se declara nunca: lo pone la sesión. Aunque los declares, se ignoran.

Si el modelo pudiera elegir el identificador del cliente, bastaría con pedírselo bien para leer la cuenta de otra persona, y no hay instrucción que arregle eso.

• tenant_id
• customer_id
• cliente_id
• account_id

4. Autenticación y riesgo

Bearer, Basic, cabecera propia u OAuth2 de credenciales de cliente. El secreto se guarda con cifrado envolvente y no se vuelve a leer desde el panel, ni siquiera para rellenar el formulario.

Marca el nivel: lectura, escritura o irreversible. Los irreversibles piden confirmación de una persona antes de ejecutarse, y todos exigen identidad verificada del cliente.

5. Pruébalo antes de encenderlo

El botón de prueba lo ejecuta con un cliente real y te enseña la petición que sale y la respuesta que entra, con las credenciales tachadas. Nadie configura un back-office ajeno a la primera sin ver eso.