Les fax sont gérés sur l’interface Liveo. Le pilotage pour l’envoi/réception peut également être réalisé avec des webservices. Cela permet de connecter/automatiser votre ERP par exemple.
Envoi d’un fax
Les paramètres à connaître pour utiliser le Web Service sont les suivants :
- login: Le login utilisé pour se connecter sur l’interface de LivéoOnIP (moncompte.masociete.fr)
- password: Le mot de passe pour se connecter sur l’interface de LivéoOnIP
- idfax: L’identifiant du fax émetteur (que l’on retrouve dans la liste déroulante qui contient les fax émetteur)
- numero: Le numéro de téléphone du destinataire du fax (ou une liste de numéros séparés par des « ; » )
Voici un exemple de code PHP pour utiliser ce Web Service :
<?
// WS envoi Fax
//récupération du fichier pdf à faxer
$fileStream = base64_encode(file_get_contents(« /chemin/du/fichier/test_fax.pdf »));
//login de connexion
$login = « compte.societe.fr »;
//mot de passe
$pwd = « 123456 »;
//id du Fax émetteur
$idFax = « 987 »;
//liste de numéros auxquels on veut envoyer le fax
$listeNum = « 0477912194;0477912193 »;
// Définition de la fonction d’encodage des headers
function http_build_headers( $headers ) {
$headers_brut = ;
foreach( $headers as $nom => $valeur ) {
$headers_brut .= $nom . ‘: ‘ . $valeur . « \r\n »;
}
return $headers_brut;
}
// Création du contenu brut de la requête
$contenu = $fileStream ;
// Définition des headers
$headers = http_build_headers( array(
‘Content-Type’ => ‘application/x-www-form-urlencoded’,
‘Content-Length’ => strlen( $contenu) ) );
// Définition du contexte
$options = array( ‘http’ => array( ‘user_agent’ => ‘Mozilla/5.0 (Windows; U; Windows NT 5.1; fr; rv:1.8.1) Gecko/20061010 Firefox/2.0’,
‘method’ => ‘POST’,
‘content’ => $contenu,
‘header’ => $headers ) );
// Création du contexte
$contexte = stream_context_create( $options );
// Envoi du formulaire POST
// CHOISIR LA LIGNE A DECOMMENTER EN FONCTION DE VOTRE ENVIRONNEMENT :
// Si vous vous connecter sur Liveo avec centrex.liveo.fr :
//$retour = file_get_contents( ‘http://webservice.centrex.liveo.fr/ws/ws_send_fax.php?login=’.$login.’&password=’.$pwd.’&idfax=’.$idFax.’&numero=’.$listeNum.’&id=true’, false, $contexte );
// OU Si vous vous connecter sur Liveo avec adista.liveo.fr :
//$retour = file_get_contents( ‘http://webservice.adista.liveo.fr/ws/ws_send_fax.php?login=’.$login.’&password=’.$pwd.’&idfax=’.$idFax.’&numero=’.$listeNum.’&id=true’, false, $contexte );
echo $retour;
?>
Voici les valeurs de retour du Web Service :
0 (tout s’est bien passé) => si id=true alors le WebService retourne les identifiants des Fax qui ont été envoyés.
Ces identifiants serviront à obtenir l’état du fax (accusé de réception) grâce au WebService Consultation_du_statut_d’un_Fax
-1 (problème de paramètres)
-2 (le compte SIP n’existe pas)
-3 (le fax émetteur n’existe pas)
-4 (le fax émetteur n’appartient pas au contexte)
-5 (le nombre de fax à envoyer est supérieur à 300)
Consultation du statut d’un fax
Nous pouvons consulter le statut d’un Fax envoyé grâce à ce Web Service.
Les paramètres à utiliser sont les suivants :
- login: Le login utilisé pour se connecter sur l’interface de LivéoOnIP (moncompte.masociete.fr)
- password: Le mot de passe pour se connecter sur l’interface de LivéoOnIP
- idfax: Identifiant du fax dont l’on veut connaître le statut
Le WebService peut appeler de la manière suivante :
- Si vous vous connecter sur Liveo avec centrex.liveo.fr :
- Si vous vous connecter sur Liveo avec adista.liveo.fr :
Les valeurs de retour de ce WebService sont les suivantes :
Si tout s’est bien passé, alors le WebService retourne les informations suivantes :
le code état du fax ; la date d’envoi du fax ; la date de réception du fax envoyé ; nombre de pages ; nombre de tentatives avant envoi
Sinon, en cas d’erreurs, les codes erreurs sont les suivants :
-1 (problème de paramètres)
-2 (le compte SIP n’existe pas)
-3 (le fax n’existe pas)
-4 (le fax n’appartient pas au contexte)
Consultation des Fax reçus
Nous pouvons consulter les fax reçus pour un fax émetteur pour une période donnée.
Les paramètres à utiliser sont les suivants :
- login: (identification auprès du serveur Centrex)
- password:
- idfax: (l’identifiant du fax émetteur que l’on veut filtrer)
- ddeb: (date de début pour filtrer les fax reçus, de la forme : jj/mm/aaaa)
- dfin: (date de fin pour filtrer les fax reçus, de la forme : jj/mm/aaaa)
Le WebService s’appelle de la manière suivante :
- Si vous vous connecter sur Liveo avec centrex.liveo.fr :
- Si vous vous connecter sur Liveo avec adista.liveo.fr :
A noter que les paramètres idfax, ddeb et dfin ne sont pas obligatoires, nous pouvons utiliser le Web Service sans contraintes temporelles
et sans choisir de Fax émetteur
Les valeurs de retour de ce Web Service sont les suivantes :
Si tout s’est bien passé, il retourne un flux XML avec le résultat de la requête.
Sinon, un code erreur :
-1 (problème de paramètres)
-2 (le compte sip n’existe pas)
-3 (pas de droit de lecture sur les Fax)
Voici un exemple de flux XML retourné par le Web Service :
<?xml version= »1.0″ encoding= »ISO-8859-1″?>
<faxs>
<fax num= »047791—-« >
<client num= »88——– » date= »2010-11-25 19:06:16″ pdf= »http://centrex.liveo.fr/fax_listen.php?idFax=Vz——–« />
<client num= »01——– » date= »2010-11-25 16:15:34″ pdf= »http://centrex.liveo.fr/fax_listen.php?idFax=AG——–« />
<client num= »88——– » date= »2010-11-25 14:57:49″ pdf= »http://centrex.liveo.fr/fax_listen.php?idFax=AG——–« />
<client num= »04——– » date= »2010-11-25 14:36:24″ pdf= »http://centrex.liveo.fr/fax_listen.php?idFax=VT——–« />
<client num= »00——– » date= »2010-11-25 14:32:38″ pdf= »http://centrex.liveo.fr/fax_listen.php?idFax=A2——–« />
<client num= »04——– » date= »2010-11-25 14:07:20″ pdf= »http://centrex.liveo.fr/fax_listen.php?idFax=Uj——–« />
<client num= »00——– » date= »2010-11-25 10:20:26″ pdf= »http://centrex.liveo.fr/fax_listen.php?idFax=A2——–« />
<client num= »04——– » date= »2010-11-25 08:49:57″ pdf= »http://centrex.liveo.fr/fax_listen.php?idFax=AW——–« />
<client num= »88——– » date= »2010-11-24 17:31:24″ pdf= »http://centrex.liveo.fr/fax_listen.php?idFax=Vj——–« />
<client num= »04——– » date= »2010-11-24 16:15:43″ pdf= »http://centrex.liveo.fr/fax_listen.php?idFax=Vz——–« />
<client num= »04——– » date= »2010-11-24 15:46:19″ pdf= »http://centrex.liveo.fr/fax_listen.php?idFax=UT——–« />
<client num= »04——– » date= »2010-11-24 15:13:10″ pdf= »http://centrex.liveo.fr/fax_listen.php?idFax=B2——–« />
<client num= »88——– » date= »2010-11-24 15:11:29″ pdf= »http://centrex.liveo.fr/fax_listen.php?idFax=BG——–« />
</fax>
</faxs>