Esendex ofrece una interfaz para el servicio web SOAP que permite a los desarrolladores integrar una funcionalidad de SMS en sus aplicaciones. Podrás acceder a todos los servicios utilizando los protocolos HTTP o HTTPS.
Hay dos versiones de la API SOAP XML SMS. Esta página describe la interfaz primaria, que utiliza los encabezados SOAP para incluir información de autenticación (cuenta, nombre de usuario y contraseña).
Hay varios entornos (p. ej., Coldfusion) que no son compatibles con los encabezados SOAP. El servicio API SOAP XML SMS sin encabezados incorpora la información de autenticación en los argumentos para cada llamada a un método.
En los SDK para SMS se incluyen implementaciones de muestra completas. Si quieres investigar el uso de los métodos de la API SOAP, te recomendamos empezar aquí. Si necesitas ayuda, ponte en contacto con el equipo de soporte técnico.
La API SOAP XML SMS ofrece funcionalidad mediante los siguientes servicios:
| Servicio | Descripción | |
|---|---|---|
| SendService | Métodos para enviar mensajes SMS de forma individual y en lotes. | URI,WSDL |
| SendContentService | Métodos para enviar mensajes SMS y entregar contenido (p. ej., WAP Push) de forma individual y en lotes. | URI,WSDL |
| ScheduledSendService | Envía a Esendex un mensaje programado para enviarse posteriormente. | URI,WSDL |
Notas
La función de generación de alias dentro de los métodos SendMessageFull y SendMessageMultipleRecipientsFull de SendService no está disponible en las cuentas de evaluación o premium. Al utilizar estos métodos, hay que especificar la referencia de la cuenta en el parámetro de originador. De lo contrario, recibirás un error al intentar enviar un mensaje.
| Servicio | Descripción | |
|---|---|---|
| InboxService | Gestionar los mensajes entrantes que se encuentran en la cola de la bandeja de entrada de la cuenta. | URI,WSDL |
| AccountEventHandler | Permite a nuestro sistema enviarte una notificación cuando tengan lugar eventos de cuenta como, por ejemplo, la recepción de un mensaje. Se trata de una definición de interfaz para un servicio web que usted en su servidor web público. Para más información, consulte Administrador de eventos de cuenta. |
URI,WSDL |
Notas
Una vez se ha creado el administrador AccountEventHandler en su servidor público, deberá configurar su cuenta para que llame a su servicio web en la sección Notificación de cuenta de la página Opciones de mensajería.
Recomendamos que, al recibir un mensaje a través del servicio AccountEventHandler, lo elimine de la bandeja de entrada utilizando InboxService. De esta manera, el sistema puede completar la transacción de entrega del mensaje y, a la vez, mantener una cola de mensajes por si su servidor no está disponible cuando llegue un mensaje.
| Servicio | Descripción | |
|---|---|---|
| AccountService | Funcionalidad de administración de la cuenta. | URI,WSDL |
| ContactService | Funcionalidad de administración de contactos y grupos de contactos. | URI,WSDL |
| SubscriptionService | Funcionalidad de administración de suscripciones. | URI,WSDL |
Si se produce un error al enviar una solicitud a un servicio web, recibirás un error SOAP en el que se describe la naturaleza del problema. Esta información se encuentra en la sección de detalles del XML y consta de dos nodos: ErrorCode y ErrorMessage. Podrás consultar la lista completa de códigos de error como ayuda para diagnosticar los posibles problemas.
Cuando decidimos integrar en nuestra aplicación el envío y recepción de SMS antepusimos ante todo la fiabilidad y accesibilidad del servicio. No queríamos tener ningún problema en este sentido. Esendex ha estado muy por encima de nuestras expectativas, no sólo en el aspecto técnico, que es muy importante, sino también en el humano.
