VALIDATA Developers

Integraciones · Contrato listo · Sin entorno

WhatsApp

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#

  1. El comprador y tu bot reúnen los datos del pedido.
  2. Antes de confirmar, el bot llama a POST /v1/channel/validations con channel: "whatsapp".
  3. El bot responde al comprador según next_action:
next_actionEjemplo 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-Key por pedido; reutilízala con el mismo cuerpo (incluido event_at) en los reintentos.
  • 503: reintenta con la misma clave, con espera creciente y tope. Si no se resuelve, pasa a una persona.
  • 429: espera Retry-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.