Integraciones · Contrato listo · Sin entorno
VALIDATA no incluye un chatbot: cualquier bot o agente de ventas (de una plataforma no-code o propio) puede consultarlo. Tu bot es quien habla con WhatsApp; VALIDATA solo responde a la llamada HTTP.
Flujo#
- El comprador y tu bot reúnen los datos del pedido.
- Antes de confirmar, el bot llama a
POST /v1/channel/validationsconchannel: "whatsapp". - El bot responde al comprador según
next_action:
next_action | Ejemplo de respuesta del bot |
|---|---|
CONTINUE_COD | «¡Listo! Tu pedido queda con pago contraentrega.» |
CONFIRM_ADDRESS_VIA_CHAT | «Confírmanos tu dirección completa, con barrio y referencias.» |
OFFER_FREIGHT_ADVANCE | «Para este pedido pedimos un abono del envío. ¿Te envío el enlace?» |
REQUIRE_PREPAID | «Para este pedido el pago es anticipado.» |
EXTRA_CONFIRMATION / HANDOFF_TO_HUMAN | «Un asesor te escribirá en unos minutos.» |
ASK_VALID_PHONE | «No pudimos validar ese número. ¿Me lo compartes con indicativo?» |
Los textos son tuyos; son solo ejemplos. No menciones al comprador scores, historial ni riesgo.
Reglas para el bot#
- Una
Idempotency-Keypor pedido; reutilízala con el mismo cuerpo (incluidoevent_at) en los reintentos. 503: reintenta con la misma clave, con espera creciente y tope. Si no se resuelve, pasa a una persona.429: esperaRetry-After.409 OPERATION_PENDING: consulta el readback; nunca cambies de clave.423 VALIDATIONS_EXHAUSTED: no reintentes; pasa el pedido a una persona.- Plazo de decisión de WhatsApp: 15 s; configura tu timeout en 20 s o más.
- Envía solo el teléfono y los datos de entrega; no envíes el texto de la conversación.
Para plataformas que solo permiten cabeceras fijas puedes usar el perfil static; si pueden ejecutar código, usa signed. Ver Autenticación.