Cómo funciona

En esta guía, tú eres quien programa el sistema del negocio, sea cual sea. El cliente es la persona que escribe por WhatsApp, Messenger, Instagram o TikTok.

Astro no recibe llamadas de tu sistema. Llama a tu origen, con un cuerpo firmado, y espera tu respuesta.

Qué publica tu sistema

El negocio configura el origen, por ejemplo https://midominio.com. Si tu API vive bajo un prefijo, el origen lo incluye: https://midominio.com/api. La ruta no se configura: es siempre la misma.

Webhook	Eventos
POST {origen}/astro/producto/webhook	catalogo.consultar
POST {origen}/astro/pedido/webhook	transaccion.crear, transaccion.cancelar

La cita no tiene una tercera ruta. Entra por astro/pedido/webhook con data.tipo en pedido o cita.

La prueba de conexión envía ping a cada webhook que tenga origen. Si el catálogo y los pedidos están en sistemas distintos, cada uno tiene su origen y los dos exponen estas rutas.

Qué activa el negocio en Astro

El dueño de la cuenta genera un secreto, pega el origen y enciende solo lo que quiere delegar:

• Catálogo externo. Astro deja de usar el catálogo cargado en la cuenta y le pregunta a tu sistema el precio y la existencia.
• Pedidos externos. El pedido se registra en tu sistema.
• Citas externas. La cita se registra en tu sistema.

Cada interruptor funciona por separado. Lo habitual es encender el catálogo junto con pedidos o citas, para que el precio que ve el cliente salga de tu sistema.

Si el negocio tiene varias sucursales, cada llamada trae la sucursal. Si tiene una sola, sucursal llega en null.

Qué respondes

Siempre el mismo sobre, en menos de 5 segundos:

{
  "RESPUESTA": "OK",
  "MENSAJE": "Pedido creado",
  "DATA": {}
}

MENSAJE es una frase corta. Cuando un pedido o una cita se rechaza, esa frase se le muestra al cliente. Astro conserva como máximo 300 caracteres.

Orden recomendado

1. Verifica la firma sobre el cuerpo tal como llegó.
2. Implementa el catálogo y responde la búsqueda con hasta 10 productos.
3. Implementa pedidos y citas y devuelve el mismo resultado si la clave se repite.
4. Usa solo los códigos de respuesta de esta guía.
5. Pide al negocio que pulse Probar en Astro. Debe llegar un ping firmado y tu OK.