Enviar Mensaje de WhatsApp sin Plantilla

URL:https://www.onurix.com/api/v1/whatsapp/send/no-template

Envíe mensajes de texto con contenido libre por WhatsApp, sin necesidad de una plantilla preaprobada por Meta. A cambio de esa flexibilidad, el envío solo es posible mientras la conversación con el destinatario siga abierta.

CONSIDERACIONES:

  • Ventana de 24 horas. Por políticas de Meta, este endpoint solo funciona con la conversación abierta: el destinatario debe haber escrito primero, y usted dispone de 24 horas contadas desde el último mensaje que él envió. Cada mensaje nuevo del destinatario reinicia el plazo. Pasadas esas 24 horas la conversación se cierra y el único camino es el envío con plantilla.
  • Antes de enviar, verifique que el negocio y el número telefónico estén en estado saludable. Si alguno presenta advertencias o bloqueos, Meta rechazará el mensaje.
  • Para recibir las respuestas del destinatario, o eventos como entregas y errores, configure un webhook desde el panel de control en onurix.com.
  • Cada petición envía a un solo número. Si incluye varios separados por coma, la petición será rechazada.
  • Por ahora solo se admiten mensajes de tipo texto ("type": "text").

Parámetros de la URL.
NombreTipoRequeridoDescripción
clientinteger(int64)trueEl Id del cliente
keystringtrueKey de la cuenta onurix
phone-sender-idstringtrueIdentificador del número telefónico registrado en Meta que se utilizará para el envío del mensaje

Parámetros del cuerpo (JSON).
NombreTipoRequeridoDescripción
phonestringtrueNúmero de teléfono destino, en formato nacional o internacional con indicativo (ej. 57 para Colombia). Un solo número por petición. Ejemplo: 573001234567
messagejsontrueObjeto con el mensaje a enviar
message.typestringtrueTipo de mensaje. Actualmente solo se admite text
message.valuestringtrueContenido del mensaje que recibirá el destinatario

Respuesta.
EstadoSignificadoDescripciónEsquema
200OKOperación exitosa JsonResponse
400Client ErrorParámetros inválidosJsonResponse
520UnknownError interno del sistemaErrorResponse
Url parameters
client: 0 key: "AQUI_SU_KEY" phone-sender-id: "AQUI_EL_ID_DEL_NUMERO_DE_TELEFONO_REMITENTE"
Body parameters example
Un solo número por petición. Hoy "type" solo acepta el valor "text".
{ "phone": "573001234567", "message": { "type": "text", "value": "Esto es un mensaje sin plantilla" } }
Respuesta de ejemplo
Response 200
{ "id": "string", "status": "string", "data": { "meta_message_id": "string", "state": "string" } }
Response 400 o 520
{
"error": 1000,
"msg": "string"
}

Si requiere asistencia o tiene un problema, envienos un mensaje para poder ayudarlo

soporte@onurix.com