Ir al contenido

Beta privada · apertura 23 de diciembre

Nexum Conecta

Nexum Conecta pone tres canales de Meta detrás de la misma clave que usas para comprobantes: una bandeja unificada, envío de mensajes, plantillas, el envío del comprobante por WhatsApp y eventos firmados hacia tu sistema. No es una copia de la API de Meta: es un conjunto de funciones con nombres de mostrador.

Una conexión es un número de WhatsApp, una cuenta de Instagram o una página de Messenger. La creas con conexion_crear, la verificas con conexion_probar y la ves o borras con conexion_ver y conexion_borrar. Borrar una conexión puede pedir la aprobación de una persona.

mensaje_enviar escribe por cualquiera de los tres canales y exige Idempotency-Key. Según tu clave, el envío espera la aprobación de una persona (202 requiere_confirmacion): mira Para agentes de IA.

WhatsApp solo deja escribir texto libre dentro de las 24 horas siguientes al último mensaje del cliente. Fuera de esa ventana debes usar una plantilla aprobada. Si no lo haces, la API responde ventana_cerrada y en detalle.plantillas_sugeridas trae opciones.

Crea y consulta plantillas con plantilla_crear y plantilla_listar. En los recordatorios de pago usa un lenguaje neutro: fecha, monto y cómo pagar.

comprobante_enviar manda un comprobante emitido con Nexum Comprobantes al cliente por WhatsApp. Reserva el precio y lo cobra solo si el envío se confirma: mira Saldo y error 402.

En lugar de consultar la bandeja, recibe los eventos en tu sistema. Cada evento llega firmado con X-Nexum-Signature; verifícala siempre y responde en menos de 10 segundos. Los pasos y los campos están en Eventos de webhook.

  • Registrar un webhook (webhook_crear) siempre espera la aprobación de una persona.
  • Un mismo evento puede llegar más de una vez: usa su id para no procesarlo dos veces.
  • Si fallas, reintentamos con espera creciente; luego el webhook se pausa y puedes reenviar con entrega_reintentar.