Saltearse al contenido
Atendium ISO

API Rest (Custom Request)

La herramienta API Rest (Custom Request) permite conectar Atendium con cualquier sistema que exponga una API HTTP. Es una de las integraciones más flexibles porque no depende de un conector nativo: el usuario define método, URL, headers, parámetros, body, archivos y reglas de ejecución.

GETPOSTPUT/PATCHDELETEArchivosMetadata

Métodos y secciones

La herramienta puede configurar:

  • Método: GET, POST, PUT, PATCH, DELETE o HEAD.
  • URL: endpoint base y paths dinámicos.
  • Query params: filtros o parámetros de búsqueda.
  • Headers: autorización, content type, tenant, API key u otros.
  • Body: JSON, parámetros, raw o multipart.
  • Archivos: envío multipart con URL, nombre y tipo de archivo.
  • Timeout y reintentos cuando el flujo lo requiere.
  • Credencial para no exponer tokens en instrucciones.

Tipos de valores

Cada campo puede alimentarse de distintas formas:

TipoQué significaEjemplo
EstáticoValor fijo definido por el usuario.X-Source: atendium
Dinámico por IAEl agente extrae o solicita el dato durante la conversación.Número de pedido, DNI, email, producto, fecha.
MetadataDato técnico del mensaje o canal.metadata.to como número de WhatsApp.
Variable guardadaDato producido por un paso anterior o workflow.lead_id creado antes.
ArchivoDocumento o media enviado a la API.Comprobante, imagen, PDF, audio.

Variables definidas por IA

Podés pedirle al agente que complete un campo si falta. Ejemplo:

{
  "order_id": "@AI(Extrae el número de pedido. Si no está, pedilo antes de llamar la API.)",
  "phone": "{{metadata.to}}",
  "reason": "@AI(Resume el motivo del reclamo en menos de 120 caracteres.)"
}

Usalo para:

  • IDs de pedido.
  • Emails.
  • Fechas.
  • Motivos de consulta.
  • Productos.
  • Montos.
  • Campos de CRM.

Metadata del mensaje

Si habilitás metadata, tu API puede recibir contexto como:

{
  "metadata": {
    "agent_id": "ID del agente",
    "agent_type": "web | whatsapp | instagram | telegram",
    "channel_id": "ID del canal",
    "to": "Identificador del usuario, por ejemplo el número de WhatsApp",
    "session_id": "ID de sesión",
    "is_training_mode": false,
    "time_zone": "America/Argentina/Buenos_Aires"
  }
}

Esto permite asociar llamadas con conversaciones, contactos, canales y sesiones.

Envío de archivos

En modo multipart, la herramienta puede enviar archivos o URLs de archivos a un endpoint externo. Es útil para:

  • Subir comprobantes.
  • Validar imágenes.
  • Adjuntar documentos a un ticket.
  • Enviar audios o PDFs a un sistema propio.

Pre-respuestas mientras se ejecuta

Todas las tools deberían tener pre-respuestas. En API REST son especialmente importantes porque el usuario no ve la llamada técnica.

Ejemplos:

  • “Estoy consultando el sistema externo.”
  • “Voy a validar esos datos.”
  • “Estoy registrando la solicitud.”
  • “Estoy enviando el archivo para revisión.”

Casos de uso

  • Consultar estado de envío.
  • Crear tickets.
  • Validar cliente por DNI o teléfono.
  • Registrar leads en un CRM propio.
  • Actualizar stock.
  • Activar un servicio.
  • Generar una factura.
  • Enviar comprobantes a backoffice.