Integraciones técnicas

Conecta tu software externo de pedidos con TENO sin cambiar tu operación

Tu software externo de pedidos mantiene el control de los pedidos. TENO recibe los eventos necesarios y se encarga de notificar al cliente cuando su pedido está listo, con historial y trazabilidad.

Una integración, responsabilidades claras

Tu sistema gestiona el pedido. TENO gestiona la notificación.

Conecta tu operación actual sin mover productos, inventario, cocina ni facturación a otra plataforma.

01

Tu software de pedidos

Mantiene el control del pedido y de la operación del restaurante.

Productos · inventario · cocina · facturación
02

TENO

Recibe el evento, notifica al cliente por el canal configurado y registra el resultado.

WhatsApp · SMS · historial · webhook
Alcance de la integración

¿Qué hace la integración?

La integración permite que tu sistema actual le indique a TENO cuándo debe notificar al cliente, sin modificar el flujo principal de tu operación.

Lo que sí hace TENO

  • Recibe la información necesaria para enviar una notificación.
  • Procesa el evento de pedido listo.
  • Permite solicitar el reenvío de una notificación.
  • Envía notificaciones por los canales configurados.
  • Registra el historial y estado de cada notificación.
  • Emite webhooks con el resultado del procesamiento.

Lo que no hace TENO

  • No reemplaza tu software externo de pedidos.
  • No administra los productos del pedido.
  • No gestiona inventario, cocina o despacho.
  • No administra la facturación de tus pedidos.
  • No define el flujo operativo de tu restaurante.
Conexión técnica

Referencia rápida

Autentica cada solicitud con tu clave de integración y usa estos endpoints para registrar y actualizar notificaciones.

Autenticación

Header requerido para cada llamada:

X-Integration-Key: tu_api_secret

Base URL de producción:

https://api.teno.com.co/integrations/v1
Endpoints disponibles POST /orders POST /orders/:orderId/ready POST /orders/:orderId/renotify GET /orders/:orderId GET /branches

Ejemplo de marcar listo

curl -X POST 'https://api.teno.com.co/integrations/v1/orders/ord_123/ready' \ -H 'X-Integration-Key: tu_api_secret' \\ -H 'Content-Type: application/json' \\ -d '{"readyAt":"2026-08-20T15:30:00Z"}'
Eventos y seguridad

Webhook firmado

Cuando una notificación se procesa, TENO puede enviar el evento order.sent a tu endpoint. Valida la firma HMAC antes de procesarlo.

Headers de seguridad

  • X-Teno-Timestamp
  • X-Teno-Signature
  • X-Teno-Event: order.sent

Buenas practicas

  • Rechazar timestamps antiguos para prevenir replay.
  • Comparar firma en tiempo constante.
  • Responder 2xx rápido y procesar de forma asíncrona.
Antes de activar

Checklist de salida a producción

Verifica estos puntos antes de conectar la integración a tu operación diaria.

  1. Guardar API secret en un vault seguro.
  2. Validar la firma del webhook en tu backend.
  3. Definir reintentos y registro de errores.
  4. Probar pedido listo, reenvío y celular inválido.
  5. Activar monitoreo de latencia y tasa de fallos.
Puedes comenzar hoy

¿Todavía no tienes una integración?

No necesitas desarrollar nada para comenzar a utilizar TENO. Puedes operar desde el panel web e integrar tu software externo de pedidos cuando tu operación lo requiera.

Ir al panel