De Comunidad

Webservice para enviar el mismo contenido a muchos celulares

WSDL: http://z4.imolko.com/zenkiu-ws/imolko-zenkiu-services.wsdl
Service: ContenidoService
Port: ContenidoSoap11
EndPoint: http://z4.imolko.com/zenkiu-ws/
Método a llamar: “enviarMensaje”.

¿Cómo realizar la llamada al método?

Para poder utilizar el método “enviarMensaje” es necesario que agregue los parámetros mostrados a continuación (son obligatorios). A continuación se muestra el Request necesario para hacer el envío de cualquier mensaje. <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:imk="http://www.springframework.org/spring-ws/Imk-Zenkiu-Services">
 <soapenv:Header/>
 <soapenv:Body>
    <imk:enviarMensajeRequest>
       <imk:usuario></imk:usuario>
       <imk:clave></imk:clave>
       <imk:mensaje></imk:mensaje>
       <imk:contacto>
          <imk:buzonSMS></imk:buzonSMS>
       </imk:contacto>
    </imk:enviarMensajeRequest>
 </soapenv:Body>
 </soapenv:Envelope>

Nota :Es Obligatorio colocar el espacio de nombre y prefijo imk en cada elemento de <imk:enviarMensajeRequest>

Detalle de cada Parámetro

Parámetros Obligatorios

1. Usuario: Parámetro string de entrada. Especifica el usuario para la autentificación.
2. Clave: Parámetro string de entrada. Especifica la clave para la autentificación.
3. Mensaje: Parámetro string de entrada. Especifica el contenido del mensaje a enviar
4. Contacto: Parámetro de tipo Contacto de entrada. Específica el número de celular (buzonSMS) de cada

contacto al que se le quiera enviar el mensaje. Este parámetro debe colocarse para cada Contacto al que se quiera enviar, por lo cual, si se va a hacer un envío a 100 personas, el mismo debe aparecer 100 veces y cada una de las veces con un número de celular diferente.

1. BuzondeSMS: Parámetro string de entrada. Especifica el número de celular del Contacto a quien va enviar un sms. El formato de esta cadena es una expresión regular de tipo: agrega esto: [+][0-9]{11,12}: donde los dos primeros dígitos pertenecen al numero de país y los restantes 11 o 12 dígitos al numero de celular. Ejemplo +584129876565 ; +18097677676

Ejemplo 
<imk:contacto>
          <imk:buzonSMS></imk:buzonSMS>
</imk:contacto>

¿Cómo será la respuesta?

La función retorna 2 valores del tipo string, llamados: código y detalle. Las posibles respuestas son:

0-Se realizó el envío completo 
1-El usuario no existe 
2-El usuario no posee permiso para el envío de mensajes 
3-No se pudo realizar la facturación del envío  
4-No se pudo realizar el envío de algún mensaje 
5-No hay contactos a quien enviar el mensaje 
6-El usuario no posee permiso para agregar Contactos 
7- Usuario o clave inválido 

A continuación se muestra el Response obtenido después de hacer un envío de cualquier mensaje.

<enviarMensajeResponse>
       <codigo>0</codigo>
       <detalle>Se realizo el envío completo</detalle>
 </enviarMensajeResponse>

Este ejemplo muestra una llamada al método, vista desde SoapUI, para realizar el envio de un mensaje a 2 Contactos o personas:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"   
xmlns:imk="http://www.springframework.org/spring-ws/Imk-Zenkiu-Services">
 <soapenv:Header/>
 <soapenv:Body>
    <imk:enviarMensajeRequest>
       <imk:usuario>lmarina</imk:usuario>
       <imk:clave>clave</imk:clave>
       <imk:mensaje>el mensaje que desea enviar</imk:mensaje>
       <imk:contacto>
          <imk:buzonSMS>+584147182530</imk:buzonSMS>
       </imk:contacto>
       <imk:contacto>
          <imk:buzonSMS>+584247076655</imk:buzonSMS>
       </imk:contacto>
    </imk:enviarMensajeRequest>
 </soapenv:Body>
 </soapenv:Envelope>

Si quieres utilizar Soapui para probar, aqui tienes las instrucciones sobre como hacerlo.

Ejemplos Prácticos

• Webservice_para_enviar_el_mismo_contenido_a_muchos_celulares PHP y Nusoap