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.
Conexiones
Sección titulada «Conexiones»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.
Enviar mensajes
Sección titulada «Enviar mensajes»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.
La ventana de 24 horas
Sección titulada «La ventana de 24 horas»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.
Leer la bandeja
Sección titulada «Leer la bandeja»conversacion_listarlista las conversaciones de los tres canales.conversacion_mensajestrae los mensajes de una conversación, con cursor.mensaje_verconsulta el estado de un mensaje enviado.
Comprobante por WhatsApp
Sección titulada «Comprobante por WhatsApp»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.
Webhooks
Sección titulada «Webhooks»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
idpara no procesarlo dos veces. - Si fallas, reintentamos con espera creciente; luego el webhook se pausa y puedes reenviar con
entrega_reintentar.