4notify Puerto Rico

Documentación de la API de 4notify para Puerto Rico

Guía práctica para conectar su sistema con 4notify y enviar mensajes de texto y WhatsApp a celulares de Puerto Rico.

1. Autenticación

La API usa JWT. Desde el panel obtiene sus credenciales de cliente, las intercambia por un token y lo envía en la cabecera Authorization: Bearer en cada llamada. Guarde las credenciales en el servidor, nunca en una app móvil o en el navegador.

2. Enviar un mensaje de texto

Haga un POST a /api/v1/sms con el número de destino y el texto. Para Puerto Rico use el formato internacional E.164: +1 seguido del código de área 787 o 939 y los siete dígitos, por ejemplo +17875550123.

Incluya en el primer mensaje el nombre de su negocio y la instrucción para darse de baja («Responda STOP para no recibir más mensajes»), como recomiendan las guías de la CTIA.

3. Enviar por WhatsApp

El punto /api/v1/whatsapp acepta el mismo número E.164. Use WhatsApp para confirmaciones y avisos a clientes que ya le escriben por ese canal; los mensajes iniciados por la empresa siguen las reglas de plantillas de WhatsApp.

4. Respuestas y bajas

  • Las respuestas de sus clientes llegan al panel y se clasifican de forma determinista.
  • STOP (y sus variantes de baja) se registra como baja: ese número deja de recibir mensajes de su remitente.
  • HELP debe contestarse con el nombre del negocio y cómo contactarle; configure ese texto en su cuenta.

5. Enviar por su propio transporte

Si prefiere, los mensajes de texto pueden salir desde su propio teléfono o desde el proveedor HTTP que ya usa. La llamada a la API es la misma; cambia solo el transporte configurado en su cuenta, y esos envíos no consumen créditos de 4notify.

Preguntas frecuentes

¿Tengo que registrar 10DLC para usar la API?

Si envía tráfico A2P por un número local de diez dígitos en EE. UU. y Puerto Rico, los operadores exigen el registro 10DLC; con un número toll-free se requiere la verificación toll-free. Si envía desde su propio teléfono, aplican las condiciones de su operador.

¿Hay horarios en los que no debo enviar?

La normativa de la FCC sobre la TCPA limita las llamadas y mensajes de telemercadeo antes de las 8:00 a. m. y después de las 9:00 p. m., hora local del destinatario. Programe sus campañas dentro de ese horario.

¿La API sirve también para correo electrónico?

Esta guía cubre SMS y WhatsApp. Si envía correos comerciales, recuerde que en EE. UU. aplica la ley CAN-SPAM.