Vue d'ensemble

L’API Fax envoie un PDF par fax depuis l’une de vos lignes Allo. Les fax envoyés et reçus apparaissent ensuite dans vos conversations, à côté des appels et des SMS.

​

Ce qu’il faut pour envoyer un fax

• Le fax sur votre compte. Le fax n’est pas disponible sur tous les comptes. Sans lui, l’API renvoie 403 avec le code FAX_NOT_AVAILABLE : contactez le support Allo pour le faire activer.
• Une ligne compatible fax. La ligne doit être un numéro local des États-Unis ou du Canada. Les numéros gratuits et les sender IDs ne peuvent pas envoyer de fax.
• Le fax activé sur la ligne. Activez Envoyer et recevoir des fax dans les paramètres du numéro, dans l’application Allo. L’API ne peut pas modifier ce réglage.
• Des crédits de messages. Chaque page envoyée utilise des crédits, le même solde que celui des SMS.

​

Comment les fax apparaissent dans les conversations

Un fax est un élément de conversation de type SMS avec message_type FAX. Son ID commence par msg-, comme tout message.

• attachments contient le PDF du fax, avec un download_url valable 30 minutes.
• page_count est le nombre de pages, ou null tant qu’il n’est pas connu.
• status d’un fax envoyé démarre à PENDING et évolue au fil de l’envoi.

Pour lister uniquement les fax, appelez Rechercher des éléments de conversation avec type: "FAX". Avec type: "SMS", les fax sont inclus avec les autres messages.