Saltar a: navegación, buscar

Diferencia entre revisiones de «API de envío de faxes»

(Descripción)
Línea 7: Línea 7:
 
===Activación===
 
===Activación===
  
Este servicio debe activarse explícitamente dentro de la web, en Oficina Virtual > Fax 9XXXXXXXX > Enviar fax > Enviar fax vía web service. En esa sección también se pueden restringir las direcciones IP desde las que se puede llamar a esta aplicación web. Si usted tiene una dirección IP fija por favor introdúzcala aquí, aumenta la seguridad.
+
Este servicio '''debe activarse explícitamente dentro de la web''', en Oficina Virtual > Fax 9XXXXXXXX > Enviar fax > Enviar fax vía web service. En esa sección también se pueden restringir las direcciones IP desde las que se puede llamar a esta aplicación web. Si usted tiene una dirección IP fija por favor introdúzcala aquí, aumenta la seguridad.
  
 
===Forma de uso===
 
===Forma de uso===
Línea 19: Línea 19:
 
  https://cgi.duocom.es/cgi-bin/telefacil2/api_enviar_fax
 
  https://cgi.duocom.es/cgi-bin/telefacil2/api_enviar_fax
  
A esta URL hay que pasarle los siguientes parámetros en forma "multipart/form-data":
+
A esta URL hay que pasarle los siguientes parámetros '''en forma "multipart/form-data"''':
  
 
* 'principal' es su número de usuario de {{PRODUCTO}}.
 
* 'principal' es su número de usuario de {{PRODUCTO}}.

Revisión del 10:48 23 nov 2010

Descripción

Con este servicio web, usted puede automatizar el envío de faxes vía Telefácil desde su infraestructura web. Este servicio replica la funcionalidad descrita en Enviar faxes desde la web.

Recuerde que también puede usar Envío de faxes vía SMTP para automatizar los envíos de faxes.

Activación

Este servicio debe activarse explícitamente dentro de la web, en Oficina Virtual > Fax 9XXXXXXXX > Enviar fax > Enviar fax vía web service. En esa sección también se pueden restringir las direcciones IP desde las que se puede llamar a esta aplicación web. Si usted tiene una dirección IP fija por favor introdúzcala aquí, aumenta la seguridad.

Forma de uso

La URL es:

https://scgi.duocom.es/cgi-bin/telefacil2/api_enviar_fax

Para los clientes de Canarias sería:

https://cgi.duocom.es/cgi-bin/telefacil2/api_enviar_fax

A esta URL hay que pasarle los siguientes parámetros en forma "multipart/form-data":

  • 'principal' es su número de usuario de Telefácil.
  • 'pin' es el PIN de la cuenta.
  • 'remitente' es el número de fax contratado en Telefácil desde el que quiere realizar el envío.
  • 'tipo_fichero' puede ser 'pdf' para archivos PDF o 'doc' para archivos Word, Excel, Powerpoint u OpenDocument.
  • 'fichero' es el archivo PDF (o DOC, o XLS, etc.) que desea enviar por fax.
  • 'destino' es el número de fax al que le va a enviar el documento. Puede ser un conjunto de números separados por comas.

Aquí hay un ejemplo de un formulario HTML que hace uso de la API de envío de faxes:

 
 Prueba de API de envio de faxes
 
 
 
Fichero: Destino:

Opcionalmente, también se pueden pasar los siguientes parámetros:

  • 'encabezado': una pequeña frase que irá en la cabecera del fax.
  • 'diferido=1': que indica que el fax no se enviará inmediatamente, sino que se retrasa su envío hasta la fecha y hora indicada por los parámetros 'anyo', 'mes', 'dia', 'hora' y 'minuto'. 'minuto' sólo puede tener 4 valores: 0, 15, 30 y 45.
  • 'portada=1': que indica que se envíe la portada configurada previamente en la web. Los campos para rellenar la portada serían:
    • 'para': receptor del fax.
    • 'remitente': nombre del remitente.
    • 'telefono': número del teléfono del remitente.
    • 'asunto': asunto del fax.
    • 'comentarios': comentarios del fax.




Indice

Portada >> Desarrolladores >> Servicio web de envío de faxes.