> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vue d'ensemble

> Envoyez un PDF par fax depuis votre ligne Allo, et consultez les fax envoyés et reçus

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](https://help.withallo.com/fr/billing/credits.md), 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](https://help.withallo.com/fr/v2/api-reference/conversations/search-conversation-items.md) avec `type: "FAX"`. Avec `type: "SMS"`, les fax sont inclus avec les autres messages.

> [card] [Envoyer un fax](https://help.withallo.com/fr/v2/api-reference/fax/send-fax.md)
>
> Envoyer un PDF par fax depuis une ligne Allo


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.