# Codes d'erreur

> Catalogue complet de tous les codes d'erreur de l'API avec instructions de resolution

Chaque reponse d'erreur inclut un champ `code` stable. Le `doc_url` de chaque erreur renvoie directement a l'entree correspondante ci-dessous. Les codes sont des contrats stables : ils ne changeront pas sans un changement de version de l'API.

## Erreurs d'authentification (401)

<table>
  <thead>
    <tr><th>Code</th><th>Description</th></tr>
  </thead>
  <tbody>
    <tr id="api_key_invalid"><td style={{ whiteSpace: 'nowrap' }}>`API_KEY_INVALID`</td><td>L'API key fournie est invalide ou n'existe pas. Verifiez votre API key dans [Parametres > API](https://web.withallo.com/settings/api).</td></tr>
    <tr id="api_key_revoked"><td style={{ whiteSpace: 'nowrap' }}>`API_KEY_REVOKED`</td><td>Cette API key a ete revoquee. Creez une nouvelle API key dans [Parametres > API](https://web.withallo.com/settings/api).</td></tr>
    <tr id="unauthorized"><td style={{ whiteSpace: 'nowrap' }}>`UNAUTHORIZED`</td><td>L'authentification est requise. Fournissez une API key valide dans le header `Authorization` sous la forme `Api-Key <your-key>`.</td></tr>
  </tbody>
</table>

## Erreurs de permission (403)

<table>
  <thead>
    <tr><th>Code</th><th>Description</th></tr>
  </thead>
  <tbody>
    <tr id="api_key_insufficient_scope"><td style={{ whiteSpace: 'nowrap' }}>`API_KEY_INSUFFICIENT_SCOPE`</td><td>Cette API key ne dispose pas du scope requis. Creez une nouvelle cle avec le scope necessaire. Voir la [correspondance scopes-endpoints](/fr/docs/guides/authentication#correspondance-scopes-endpoints).</td></tr>
    <tr id="api_key_trial_not_allowed"><td style={{ whiteSpace: 'nowrap' }}>`API_KEY_TRIAL_NOT_ALLOWED`</td><td>L'acces API n'est pas disponible sur les plans d'essai. Passez a un plan payant.</td></tr>
    <tr id="forbidden"><td style={{ whiteSpace: 'nowrap' }}>`FORBIDDEN`</td><td>Vous n'avez pas la permission d'effectuer cette action. Contactez l'administrateur de votre workspace.</td></tr>
    <tr id="a2p_not_enabled"><td style={{ whiteSpace: 'nowrap' }}>`A2P_NOT_ENABLED`</td><td>Le SMS A2P (Application-to-Person) n'est pas active pour ce numero. Completez l'enregistrement 10DLC dans le tableau de bord Allo.</td></tr>
    <tr id="fax_not_available"><td style={{ whiteSpace: 'nowrap' }}>`FAX_NOT_AVAILABLE`</td><td>Le fax n'est pas disponible pour ce compte. Contactez le support Allo pour le faire activer.</td></tr>
    <tr id="allo_number_forbidden"><td style={{ whiteSpace: 'nowrap' }}>`ALLO_NUMBER_FORBIDDEN`</td><td>Vous n'avez pas accès à cette ligne Allo. Listez les lignes auxquelles vous avez accès avec `GET /v2/api/numbers`.</td></tr>
    <tr id="not_note_author"><td style={{ whiteSpace: 'nowrap' }}>`NOT_NOTE_AUTHOR`</td><td>Seul l'auteur de la note peut la modifier ou la supprimer.</td></tr>
    <tr id="not_comment_author"><td style={{ whiteSpace: 'nowrap' }}>`NOT_COMMENT_AUTHOR`</td><td>Seul l'auteur du commentaire peut le modifier.</td></tr>
    <tr id="agent_transfer_rule_member_no_line_access"><td style={{ whiteSpace: 'nowrap' }}>`AGENT_TRANSFER_RULE_MEMBER_NO_LINE_ACCESS`</td><td>Le membre visé par une règle de transfert n'a pas accès à cette ligne. Choisissez-en un qui y a accès, depuis `GET /v2/api/users`.</td></tr>
    <tr id="partner_access_required"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ACCESS_REQUIRED`</td><td>Ce compte n'est pas un partenaire activé. L'accès partenaire est accordé par Allo, écrivez à [partnership@themobilefirst.co](mailto:partnership@themobilefirst.co).</td></tr>
    <tr id="partner_contract_cannot_provision"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_CONTRACT_CANNOT_PROVISION`</td><td>Votre contrat partenaire ne permet pas de créer des comptes ni d'en obtenir le prix. Seuls les partenaires Licence à prix réduit (revendeurs) le peuvent.</td></tr>
    <tr id="partner_cannot_deactivate"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_CANNOT_DEACTIVATE`</td><td>Votre contrat partenaire ne permet pas de désactiver ce compte. Seuls les partenaires Licence à prix réduit (revendeurs) le peuvent.</td></tr>
    <tr id="account_suspended"><td style={{ whiteSpace: 'nowrap' }}>`ACCOUNT_SUSPENDED`</td><td>Le compte est suspendu : il ne peut plus envoyer de SMS tant qu'il n'est pas réactivé. Demandez au fournisseur du compte de le réactiver, puis réessayez. Un partenaire réactive un compte avec `POST /v2/api/partner/accounts/{id}/resume`.</td></tr>
    <tr id="recording_access_denied"><td style={{ whiteSpace: 'nowrap' }}>`RECORDING_ACCESS_DENIED`</td><td>L'utilisateur de cette API key ne peut pas écouter l'enregistrement de cet appel. Seuls le propriétaire de la ligne, un admin ou manager de l'équipe, un membre avec qui la ligne est partagée, ou le destinataire d'un partage de résumé le peuvent. Utilisez la clé de l'un d'eux.</td></tr>
    <tr id="recording_download_restricted"><td style={{ whiteSpace: 'nowrap' }}>`RECORDING_DOWNLOAD_RESTRICTED`</td><td>La ligne appartient à une équipe HIPAA : Allo ne crée aucun lien de téléchargement pour ses enregistrements. Écoutez l'enregistrement dans l'application Allo.</td></tr>
    <tr id="view_permission_denied"><td style={{ whiteSpace: 'nowrap' }}>`VIEW_PERMISSION_DENIED`</td><td>Seul le propriétaire d'une vue d'équipe, ou un ADMIN ou MANAGER de l'équipe, peut la modifier ou la supprimer.</td></tr>
  </tbody>
</table>

## Erreurs de validation (400)

<table>
  <thead>
    <tr><th>Code</th><th>Description</th></tr>
  </thead>
  <tbody>
    <tr id="invalid_request_body"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_REQUEST_BODY`</td><td>Le corps de la requete n'a pas pu etre analyse. Assurez-vous que le Content-Type est `application/json` et que le corps est du JSON bien forme.</td></tr>
    <tr id="missing_parameter"><td style={{ whiteSpace: 'nowrap' }}>`MISSING_PARAMETER`</td><td>Un parametre de requete obligatoire est manquant. Ajoutez le parametre nomme dans le champ `param`.</td></tr>
    <tr id="invalid_parameter"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_PARAMETER`</td><td>Un paramètre de requête est mal formé, par exemple `pinned=yes` au lieu de `true` ou `false`. Le paramètre est nommé dans `param`.</td></tr>
    <tr id="missing_header"><td style={{ whiteSpace: 'nowrap' }}>`MISSING_HEADER`</td><td>Un header obligatoire est manquant. Ajoutez le header nomme dans le champ `param`.</td></tr>
    <tr id="unsupported_media_type"><td style={{ whiteSpace: 'nowrap' }}>`UNSUPPORTED_MEDIA_TYPE`</td><td>Le Content-Type n'est pas supporte. Utilisez `application/json`. Retourne `415`.</td></tr>
    <tr id="invalid_page_size"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_PAGE_SIZE`</td><td>La valeur du parametre `size` est invalide. Fournissez une valeur numerique entre 1 et 100.</td></tr>
    <tr id="invalid_search_query"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_SEARCH_QUERY`</td><td>Le parametre `search` doit contenir au moins un caractere alphanumerique. Les caracteres speciaux sont supprimes automatiquement : fournissez des mots-cles en texte brut (par ex., `"john"` ou `"missed call"`). Les mots sont combines avec AND et font l'objet d'une correspondance par prefixe.</td></tr>
    <tr id="missing_allo_number"><td style={{ whiteSpace: 'nowrap' }}>`MISSING_ALLO_NUMBER`</td><td>Le parametre `allo_number` est requis. Ajoutez-le a votre requete. Listez vos numeros avec `GET /v2/api/numbers`.</td></tr>
    <tr id="invalid_date_range"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_DATE_RANGE`</td><td>La plage de dates est invalide : `from` doit etre anterieur a `to`. Utilisez le format `YYYY-MM-DD`.</td></tr>
    <tr id="date_range_too_wide"><td style={{ whiteSpace: 'nowrap' }}>`DATE_RANGE_TOO_WIDE`</td><td>La plage de dates depasse le nombre maximum de jours autorise. Reduisez votre plage de dates.</td></tr>
    <tr id="invalid_item_id"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_ITEM_ID`</td><td>Le prefixe de l'ID de l'element n'est pas reconnu. Utilisez les IDs de l'API conversations : `cll-` pour les appels, `msg-` pour les messages.</td></tr>
    <tr id="batch_too_large"><td style={{ whiteSpace: 'nowrap' }}>`BATCH_TOO_LARGE`</td><td>La taille du lot depasse le maximum de 100. Divisez votre requete en lots de 100 ou moins.</td></tr>
    <tr id="tags_required"><td style={{ whiteSpace: 'nowrap' }}>`TAGS_REQUIRED`</td><td>Au moins un tag est requis. Fournissez un tableau `tags` non vide. Listez les tags disponibles avec `GET /v2/api/tags`.</td></tr>
    <tr id="invalid_action"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_ACTION`</td><td>Valeur d'action inconnue. Utilisez l'une des valeurs suivantes : `READ`, `UNREAD`, `ARCHIVE`, `UNARCHIVE`.</td></tr>
    <tr id="invalid_granularity"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_GRANULARITY`</td><td>Valeur de granularite inconnue. Utilisez l'une des valeurs suivantes : `DAY`, `WEEK`, `MONTH`.</td></tr>
    <tr id="invalid_group_by"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_GROUP_BY`</td><td>Valeur `group_by` inconnue. Consultez le champ `suggestion` pour les valeurs autorisees.</td></tr>
    <tr id="unsupported_extend_value"><td style={{ whiteSpace: 'nowrap' }}>`UNSUPPORTED_EXTEND_VALUE`</td><td>Valeur `extend` inconnue. Actuellement supporte : `transcript`.</td></tr>
    <tr id="method_not_allowed"><td style={{ whiteSpace: 'nowrap' }}>`METHOD_NOT_ALLOWED`</td><td>Methode HTTP non supportee pour cet endpoint. Consultez le champ `suggestion` pour les methodes supportees. Retourne `405`.</td></tr>
    <tr id="invalid_phone_format"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_PHONE_FORMAT`</td><td>Le numero de telephone n'est pas au format E.164 valide. Utilisez le format : `+14155551234` (prefixe +, code pays, sans espaces ni tirets).</td></tr>
    <tr id="invalid_to_number"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_TO_NUMBER`</td><td>Le numero de destination est invalide ou injoignable. Fournissez un numero de telephone E.164 valide.</td></tr>
    <tr id="to_number_country_mismatch"><td style={{ whiteSpace: 'nowrap' }}>`TO_NUMBER_COUNTRY_MISMATCH`</td><td>Les SMS internationaux ne sont pas supportes pour ce numero. Utilisez un numero de telephone dans le meme pays que le destinataire.</td></tr>
    <tr id="number_not_sms_enabled"><td style={{ whiteSpace: 'nowrap' }}>`NUMBER_NOT_SMS_ENABLED`</td><td>Ce numero n'a pas les SMS sortants actives. Activez les SMS dans le tableau de bord, ou utilisez un autre numero depuis `GET /v2/api/numbers`.</td></tr>
    <tr id="sender_id_inbox_cannot_send_sms"><td style={{ whiteSpace: 'nowrap' }}>`SENDER_ID_INBOX_CANNOT_SEND_SMS`</td><td>Les boites de reception Sender ID ne peuvent pas envoyer de SMS. Utilisez un numero de telephone classique a la place.</td></tr>
    <tr id="sender_id_not_active"><td style={{ whiteSpace: 'nowrap' }}>`SENDER_ID_NOT_ACTIVE`</td><td>Le sender ID n'est pas actif. Activez le sender ID dans le tableau de bord Allo avant d'envoyer.</td></tr>
    <tr id="message_not_compliant"><td style={{ whiteSpace: 'nowrap' }}>`MESSAGE_NOT_COMPLIANT`</td><td>Le contenu du message ne respecte pas les regles de conformite. Supprimez le contenu non autorise et reessayez.</td></tr>
    <tr id="landline_number_not_supported"><td style={{ whiteSpace: 'nowrap' }}>`LANDLINE_NUMBER_NOT_SUPPORTED`</td><td>Le numero de destination est un fixe et ne peut pas recevoir de SMS. Fournissez un numero de telephone mobile a la place.</td></tr>
    <tr id="fax_not_supported_on_number"><td style={{ whiteSpace: 'nowrap' }}>`FAX_NOT_SUPPORTED_ON_NUMBER`</td><td>La ligne `from` ne peut pas envoyer de fax. Seuls les numéros locaux des États-Unis et du Canada le peuvent, pas les numéros gratuits ni les sender IDs. Choisissez une autre ligne avec `GET /v2/api/numbers`.</td></tr>
    <tr id="fax_not_enabled_on_line"><td style={{ whiteSpace: 'nowrap' }}>`FAX_NOT_ENABLED_ON_LINE`</td><td>Le fax est désactivé sur la ligne `from`. Activez **Envoyer et recevoir des fax** dans les paramètres du numéro, dans l'application Allo, ou utilisez une autre ligne.</td></tr>
    <tr id="fax_file_not_pdf"><td style={{ whiteSpace: 'nowrap' }}>`FAX_FILE_NOT_PDF`</td><td>Le fichier du fax n'est pas un PDF. Envoyez le document en PDF avec le type de contenu `application/pdf`.</td></tr>
    <tr id="fax_file_empty"><td style={{ whiteSpace: 'nowrap' }}>`FAX_FILE_EMPTY`</td><td>Le fichier du fax est vide. Joignez un PDF non vide dans la partie `file`.</td></tr>
    <tr id="max_upload_size_exceeded"><td style={{ whiteSpace: 'nowrap' }}>`MAX_UPLOAD_SIZE_EXCEEDED`</td><td>Le fichier envoyé est trop volumineux. Un fichier de fax pèse 12 Mo au maximum : compressez le PDF ou répartissez-le sur plusieurs fax.</td></tr>
    <tr id="empty_note_content"><td style={{ whiteSpace: 'nowrap' }}>`EMPTY_NOTE_CONTENT`</td><td>Le contenu de la note ou du commentaire est vide. Fournissez une valeur `content` non vide.</td></tr>
    <tr id="note_content_too_long"><td style={{ whiteSpace: 'nowrap' }}>`NOTE_CONTENT_TOO_LONG`</td><td>Le contenu de la note ou du commentaire dépasse le maximum de 4 000 caractères. Raccourcissez le contenu.</td></tr>
    <tr id="missing_allo_number_or_sender_id"><td style={{ whiteSpace: 'nowrap' }}>`MISSING_ALLO_NUMBER_OR_SENDER_ID`</td><td>Fournissez soit `allo_number` (ligne Allo au format E.164), soit `sender_id` (boîte sender ID). Listez vos numéros avec `GET /v2/api/numbers`.</td></tr>
    <tr id="contact_notes_unavailable"><td style={{ whiteSpace: 'nowrap' }}>`CONTACT_NOTES_UNAVAILABLE`</td><td>Les notes de contact ne sont pas encore disponibles pour ce workspace : il doit être sur le modèle de contacts v2. Contactez le support si vous pensez qu'il s'agit d'une erreur.</td></tr>
    <tr id="invalid_thread_entity_type"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_THREAD_ENTITY_TYPE`</td><td>Valeur `entity_type` inconnue. Utilisez l'une des valeurs suivantes : `CALL`, `TEXT_MESSAGE`, `CONVERSATION_NOTE`.</td></tr>
    <tr id="unknown_field"><td style={{ whiteSpace: 'nowrap' }}>`UNKNOWN_FIELD`</td><td>Le corps de la requête contient un champ que l'endpoint n'accepte pas, nommé dans `param`. Souvent une faute de frappe, ou un champ en lecture seule comme `custom_prompt`.</td></tr>
    <tr id="missing_field"><td style={{ whiteSpace: 'nowrap' }}>`MISSING_FIELD`</td><td>Un champ obligatoire manque, nommé dans `param`. Dans une collection, il porte l'index, par exemple `transfer_rules[1].description`.</td></tr>
    <tr id="invalid_phone_number"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_PHONE_NUMBER`</td><td>Le numéro nommé dans `param` n'a pas pu être lu. Utilisez le format E.164, par exemple `+33612345678`.</td></tr>
    <tr id="invalid_timezone"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_TIMEZONE`</td><td>Ce n'est pas un identifiant de fuseau IANA. Utilisez par exemple `Europe/Paris` ou `America/New_York`.</td></tr>
    <tr id="invalid_agent_language"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_AGENT_LANGUAGE`</td><td>Langue de réceptionniste IA inconnue. Les valeurs acceptées sont listées dans le message.</td></tr>
    <tr id="invalid_agent_capability"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_AGENT_CAPABILITY`</td><td>Clé de capacité inconnue. Utilisez `SCHEDULING`, `CALL_TRANSFER` ou `WARM_TRANSFER`, en majuscules.</td></tr>
    <tr id="agent_transfer_rule_target_required"><td style={{ whiteSpace: 'nowrap' }}>`AGENT_TRANSFER_RULE_TARGET_REQUIRED`</td><td>Une règle de transfert n'a pas la cible qu'exige son type : `target_number`, `target_member_id` ou `target_line_number`.</td></tr>
    <tr id="agent_no_forwarding_number"><td style={{ whiteSpace: 'nowrap' }}>`AGENT_NO_FORWARDING_NUMBER`</td><td>Désactiver le réceptionniste IA renvoie les appels vers votre téléphone professionnel, et aucun n'est renseigné sur l'espace de travail.</td></tr>
    <tr id="agent_calendar_team_mismatch"><td style={{ whiteSpace: 'nowrap' }}>`AGENT_CALENDAR_TEAM_MISMATCH`</td><td>L'agenda appartient à une autre équipe. Listez ceux que vous pouvez utiliser avec `GET /v2/api/calendars`.</td></tr>
    <tr id="agent_calendar_event_types_not_supported"><td style={{ whiteSpace: 'nowrap' }}>`AGENT_CALENDAR_EVENT_TYPES_NOT_SUPPORTED`</td><td>Le fournisseur de cet agenda n'a pas de types d'événement. Associez-le à une liste vide.</td></tr>
    <tr id="invalid_knowledge_url"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_KNOWLEDGE_URL`</td><td>L'URL n'a pas d'hôte public. Envoyez l'URL d'un site accessible publiquement, par exemple `https://example.com`.</td></tr>
    <tr id="prompt_sections_required"><td style={{ whiteSpace: 'nowrap' }}>`PROMPT_SECTIONS_REQUIRED`</td><td>`sections` est vide. Il remplace tout le prompt et doit donc porter chaque section à conserver.</td></tr>
    <tr id="invalid_agent_prompt_section"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_AGENT_PROMPT_SECTION`</td><td>Clé de section de prompt inconnue. Les clés acceptées sont listées dans le message.</td></tr>
    <tr id="duplicate_agent_prompt_section"><td style={{ whiteSpace: 'nowrap' }}>`DUPLICATE_AGENT_PROMPT_SECTION`</td><td>Une section de prompt apparaît plusieurs fois. Envoyez chacune au maximum une fois.</td></tr>
    <tr id="invalid_agent_prompt_section_body"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_AGENT_PROMPT_SECTION_BODY`</td><td>Une section de prompt porte le mauvais corps. `required_fields` prend `fields`, toutes les autres prennent `content`.</td></tr>
    <tr id="missing_agent_prompt_section"><td style={{ whiteSpace: 'nowrap' }}>`MISSING_AGENT_PROMPT_SECTION`</td><td>`objective`, `personality` et `behaviors` sont obligatoires et l'une d'elles est absente ou vide.</td></tr>
    <tr id="agent_prompt_section_too_long"><td style={{ whiteSpace: 'nowrap' }}>`AGENT_PROMPT_SECTION_TOO_LONG`</td><td>Une section de prompt dépasse 3 000 caractères. Raccourcissez-la.</td></tr>
    <tr id="agent_prompt_too_long"><td style={{ whiteSpace: 'nowrap' }}>`AGENT_PROMPT_TOO_LONG`</td><td>Le prompt généré depuis toutes les sections dépasse 25 000 caractères. Raccourcissez les sections.</td></tr>
    <tr id="attribute_label_invalid"><td style={{ whiteSpace: 'nowrap' }}>`ATTRIBUTE_LABEL_INVALID`</td><td>`label` est vide, dépasse 255 caractères ou ne contient ni lettre ni chiffre.</td></tr>
    <tr id="attribute_key_reserved"><td style={{ whiteSpace: 'nowrap' }}>`ATTRIBUTE_KEY_RESERVED`</td><td>Le label correspond à la clé d'un champ natif, comme `name`, `company` ou `job_title` pour les contacts, ou `name`, `website` ou `industry` pour les entreprises. Choisissez un autre label.</td></tr>
    <tr id="attribute_options_not_supported"><td style={{ whiteSpace: 'nowrap' }}>`ATTRIBUTE_OPTIONS_NOT_SUPPORTED`</td><td>`options` a été envoyé pour un attribut qui n'est pas une liste déroulante. N'envoyez `options` que pour les attributs `DROPDOWN`.</td></tr>
    <tr id="attribute_option_invalid"><td style={{ whiteSpace: 'nowrap' }}>`ATTRIBUTE_OPTION_INVALID`</td><td>Chaque option doit avoir un `label` non vide d'au plus 255 caractères, unique dans l'attribut, et une liste déroulante doit avoir au moins une option.</td></tr>
    <tr id="attribute_built_in"><td style={{ whiteSpace: 'nowrap' }}>`ATTRIBUTE_BUILT_IN`</td><td>La clé est celle d'un champ natif, comme `name` ou `company`, et non d'un champ personnalisé. Les champs natifs ne peuvent être ni modifiés ni supprimés via les endpoints de champs personnalisés.</td></tr>
    <tr id="custom_attribute_key_unknown"><td style={{ whiteSpace: 'nowrap' }}>`CUSTOM_ATTRIBUTE_KEY_UNKNOWN`</td><td>`custom_attributes` contient une clé qui n'est pas un attribut personnalisé actif. Listez les clés avec `GET /v2/api/crm/attributes` pour les personnes ou `GET /v2/api/crm/companies/attributes` pour les entreprises. `param` vaut `custom_attributes.<key>`.</td></tr>
    <tr id="custom_attribute_value_invalid"><td style={{ whiteSpace: 'nowrap' }}>`CUSTOM_ATTRIBUTE_VALUE_INVALID`</td><td>La valeur ne correspond pas au type de l'attribut, par exemple une chaîne pour un `NUMBER` ou une valeur de liste déroulante qui n'est pas une option. Vérifiez le type, ou envoyez `null` pour effacer la valeur. `param` vaut `custom_attributes.<key>`.</td></tr>
    <tr id="esim_not_available_in_country"><td style={{ whiteSpace: 'nowrap' }}>`ESIM_NOT_AVAILABLE_IN_COUNTRY`</td><td>`number_preference.esim` vaut `true` avec un pays autre que `FR`. Les numéros eSIM ne sont disponibles qu'en France.</td></tr>
    <tr id="invalid_esim_tier"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_ESIM_TIER`</td><td>Palier eSIM inconnu. Utilisez un `code` renvoyé par `GET /v2/api/partner/accounts/{account_id}/esims/offer`.</td></tr>
    <tr id="invalid_esim_topup"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_ESIM_TOPUP`</td><td>Recharge eSIM inconnue, nommée dans `param` (`code`). Utilisez un `top_ups[].code` renvoyé par `GET /v2/api/partner/accounts/{account_id}/esims/offer`.</td></tr>
    <tr id="partner_account_owner_not_removable"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ACCOUNT_OWNER_NOT_REMOVABLE`</td><td>Le compte lui-même n'est pas un membre et ne peut pas être retiré de son workspace. Pour mettre fin au compte, utilisez `DELETE /v2/api/partner/accounts/{id}`.</td></tr>
    <tr id="partner_member_number_choice_conflict"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_MEMBER_NUMBER_CHOICE_CONFLICT`</td><td>`phone_number` et `number_preference` ont été envoyés ensemble. Envoyez `phone_number` pour transférer un numéro que le compte détient, ou `number_preference` pour un nouveau numéro.</td></tr>
    <tr id="esim_identity_incomplete"><td style={{ whiteSpace: 'nowrap' }}>`ESIM_IDENTITY_INCOMPLETE`</td><td>L'`identity` de l'eSIM est absente ou incomplète : `corporate_name`, `postal_address`, `postal_code` (5 chiffres) et `city` sont requis.</td></tr>
    <tr id="sender_id_invalid_format"><td style={{ whiteSpace: 'nowrap' }}>`SENDER_ID_INVALID_FORMAT`</td><td>Le `sender_id` doit compter 1 à 11 lettres ou chiffres, sans espace ni symbole, par exemple `MYBRAND`.</td></tr>
    <tr id="example_content_too_long"><td style={{ whiteSpace: 'nowrap' }}>`EXAMPLE_CONTENT_TOO_LONG`</td><td>L'`example_content` du Sender ID dépasse 1 000 caractères. Raccourcissez-le.</td></tr>
    <tr id="invalid_idempotency_key"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_IDEMPOTENCY_KEY`</td><td>L'en-tête `Idempotency-Key` doit contenir de 8 à 100 lettres, chiffres, `-` ou `_`. Envoyez un UUID.</td></tr>
    <tr id="idempotency_key_required"><td style={{ whiteSpace: 'nowrap' }}>`IDEMPOTENCY_KEY_REQUIRED`</td><td>Cette requête exige un en-tête `Idempotency-Key`, nommé dans `param`, pour qu'une nouvelle tentative ne débite pas deux fois. Obligatoire sur `POST /v2/api/partner/esims/{id}/topups`. Envoyez un UUID, et le même quand vous réessayez.</td></tr>
    <tr id="invalid_number_preference"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_NUMBER_PREFERENCE`</td><td>Le `country` de la préférence de numéro est inconnu ou non pris en charge. Envoyez un code pays ISO, par exemple `FR`.</td></tr>
    <tr id="invalid_member_role"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_MEMBER_ROLE`</td><td>`role` de membre inconnu. Utilisez `ADMIN`, `MANAGER` ou `MEMBER`.</td></tr>
    <tr id="invalid_filter_field"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_FILTER_FIELD`</td><td>Le `field` d'un filtre de vue n'est ni un champ natif d'une personne ni la `key` d'un champ personnalisé. Listez les champs personnalisés avec `GET /v2/api/crm/attributes`.</td></tr>
    <tr id="invalid_filter_operator"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_FILTER_OPERATOR`</td><td>L'`operator` d'un filtre de vue ne correspond pas au type de son champ.</td></tr>
    <tr id="invalid_filter_value"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_FILTER_VALUE`</td><td>La `value` d'un filtre de vue n'est pas lisible pour le type de son champ. Utilisez une valeur numérique pour un champ nombre et une date ISO 8601 comme `2026-01-31` ou `2026-01-31T00:00:00Z` pour un champ date.</td></tr>
    <tr id="invalid_sort_field"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_SORT_FIELD`</td><td>Le `field` d'un tri de vue n'est ni un champ natif ni la `key` d'un champ personnalisé issue de `GET /v2/api/crm/attributes`.</td></tr>
    <tr id="field_not_sortable"><td style={{ whiteSpace: 'nowrap' }}>`FIELD_NOT_SORTABLE`</td><td>Le `field` d'un tri de vue existe mais ne peut pas être trié. Utilisez un champ natif triable ou un champ personnalisé triable.</td></tr>
    <tr id="invalid_request"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_REQUEST`</td><td>La requête n'est pas valide dans son ensemble. Sur `GET /v2/api/conversations`, envoyez exactement un des deux paramètres `allo_number` ou `inbox_id`, ni les deux ni aucun.</td></tr>
    <tr id="inbox_name_required"><td style={{ whiteSpace: 'nowrap' }}>`INBOX_NAME_REQUIRED`</td><td>Une boîte de réception a besoin d'un `name` non vide. Envoyez un nom court comme `Ventes`.</td></tr>
    <tr id="invalid_inbox_source"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_INBOX_SOURCE`</td><td>Une source est invalide : une source, une condition ou une touche nulle ou invalide, un chemin de menu absent de `GET /v2/api/numbers/{number}/menu_options` pour cette ligne, deux sources avec le même `allo_number`, ou une boîte de coéquipier qui n'aurait plus aucune ligne dans l'espace de travail de l'appelant. Les conditions de menu ne sont acceptées que sur les lignes dont la liste d'options de menu n'est pas vide ; sur les autres lignes, utilisez une source sur toute la ligne (`conditions` vides). Pour combiner plusieurs options d'une ligne, mettez tous leurs chemins dans les `branches` d'une seule `MENU_BRANCH`.</td></tr>
    <tr id="invalid_inbox_filters"><td style={{ whiteSpace: 'nowrap' }}>`INVALID_INBOX_FILTERS`</td><td>Les `filters` de la boîte contiennent une clé inconnue ou une valeur invalide. Clés acceptées : `types`, `user_ids` (50 au maximum), `contact_ids` (50 au maximum), `contact_list_ids` (10 au maximum) et `tag_keys` (20 au maximum, chacun un tag de votre espace de travail). "Non lues uniquement" n'est pas enregistré sur une boîte : utilisez le paramètre de requête `unread` de `GET /v2/api/conversations`.</td></tr>
    <tr id="inbox_limit_reached"><td style={{ whiteSpace: 'nowrap' }}>`INBOX_LIMIT_REACHED`</td><td>Le propriétaire de la boîte a déjà 50 boîtes de réception. Supprimez-en une avec `DELETE /v2/api/inboxes/{inbox_id}`.</td></tr>
    <tr id="feature_not_supported"><td style={{ whiteSpace: 'nowrap' }}>`FEATURE_NOT_SUPPORTED`</td><td>Filtrer les conversations par le paramètre indiqué dans `param` (`inbox_id` ou `pinned`) n'est pas encore disponible. Listez les conversations d'une ligne avec `allo_number`, sans ce paramètre.</td></tr>
    <tr id="contact_filter_not_supported"><td style={{ whiteSpace: 'nowrap' }}>`CONTACT_FILTER_NOT_SUPPORTED`</td><td>La boîte a des filtres de contacts enregistrés, et cet espace de travail utilise encore l'ancien modèle de contacts, qui ne peut pas filtrer les conversations par contact ou liste de contacts. Retirez `contact_ids` et `contact_list_ids` des filtres de la boîte avec `PATCH /v2/api/inboxes/{inbox_id}`.</td></tr>
  </tbody>
</table>

## Erreurs de ressource introuvable (404)

<table>
  <thead>
    <tr><th>Code</th><th>Description</th></tr>
  </thead>
  <tbody>
    <tr id="conversation_item_not_found"><td style={{ whiteSpace: 'nowrap' }}>`CONVERSATION_ITEM_NOT_FOUND`</td><td>Aucun appel ou message trouve avec cet ID. Recherchez l'element avec `POST /v2/api/conversations/items/search`.</td></tr>
    <tr id="member_not_found"><td style={{ whiteSpace: 'nowrap' }}>`MEMBER_NOT_FOUND`</td><td>Aucun membre d'equipe trouve avec cet ID. Listez les membres de l'equipe avec `GET /v2/api/users`.</td></tr>
    <tr id="team_not_found"><td style={{ whiteSpace: 'nowrap' }}>`TEAM_NOT_FOUND`</td><td>Aucune equipe trouvee pour l'utilisateur authentifie. Verifiez la configuration de l'equipe dans le tableau de bord Allo.</td></tr>
    <tr id="user_not_found"><td style={{ whiteSpace: 'nowrap' }}>`USER_NOT_FOUND`</td><td>Le compte utilisateur authentifie n'a pas ete trouve. Verifiez que l'API key est associee a un compte actif.</td></tr>
    <tr id="business_not_found"><td style={{ whiteSpace: 'nowrap' }}>`BUSINESS_NOT_FOUND`</td><td>Aucun compte business trouve pour l'utilisateur authentifie. Assurez-vous que le compte a termine l'onboarding.</td></tr>
    <tr id="call_not_found"><td style={{ whiteSpace: 'nowrap' }}>`CALL_NOT_FOUND`</td><td>Aucun appel trouve avec cet ID. Recherchez les appels avec `POST /v2/api/conversations/items/search`.</td></tr>
    <tr id="text_message_not_found"><td style={{ whiteSpace: 'nowrap' }}>`TEXT_MESSAGE_NOT_FOUND`</td><td>Aucun message texte trouve avec cet ID. Recherchez les messages avec `POST /v2/api/conversations/items/search`.</td></tr>
    <tr id="phone_number_not_found"><td style={{ whiteSpace: 'nowrap' }}>`PHONE_NUMBER_NOT_FOUND`</td><td>Aucun numero de telephone trouve pour votre compte. Listez vos numeros avec `GET /v2/api/numbers`.</td></tr>
    <tr id="from_number_not_found"><td style={{ whiteSpace: 'nowrap' }}>`FROM_NUMBER_NOT_FOUND`</td><td>Aucun numero de telephone Allo trouve pour votre compte. Listez vos numeros disponibles avec `GET /v2/api/numbers`.</td></tr>
    <tr id="tag_not_found"><td style={{ whiteSpace: 'nowrap' }}>`TAG_NOT_FOUND`</td><td>Le tag n'existe pas sur cet element de conversation. Il a peut-etre deja ete supprime.</td></tr>
    <tr id="sender_id_not_found"><td style={{ whiteSpace: 'nowrap' }}>`SENDER_ID_NOT_FOUND`</td><td>Aucun sender ID actif trouve. Verifiez vos sender IDs dans le tableau de bord Allo.</td></tr>
    <tr id="endpoint_not_found"><td style={{ whiteSpace: 'nowrap' }}>`ENDPOINT_NOT_FOUND`</td><td>Aucun endpoint trouve a cette URL. Verifiez l'URL et la methode HTTP. Voir la [reference API](/fr/docs).</td></tr>
    <tr id="person_not_found"><td style={{ whiteSpace: 'nowrap' }}>`PERSON_NOT_FOUND`</td><td>Aucune personne trouvée avec cet ID (`per-*`). Recherchez des personnes avec `POST /v2/api/crm/people/search`.</td></tr>
    <tr id="note_not_found"><td style={{ whiteSpace: 'nowrap' }}>`NOTE_NOT_FOUND`</td><td>Aucune note trouvée avec cet ID. Listez les notes d'une conversation avec `GET /v2/api/conversations/{contact_number}/notes`.</td></tr>
    <tr id="thread_not_found"><td style={{ whiteSpace: 'nowrap' }}>`THREAD_NOT_FOUND`</td><td>Aucun fil trouvé avec cet ID. Retrouvez le fil d'un élément avec `GET /v2/api/threads?entity_type=...&entity_id=...`.</td></tr>
    <tr id="thread_comment_not_found"><td style={{ whiteSpace: 'nowrap' }}>`THREAD_COMMENT_NOT_FOUND`</td><td>Aucun commentaire de fil trouvé avec cet ID. Récupérez le fil avec `GET /v2/api/threads/{id}` pour voir ses commentaires.</td></tr>
    <tr id="agent_voice_not_found"><td style={{ whiteSpace: 'nowrap' }}>`AGENT_VOICE_NOT_FOUND`</td><td>Aucune voix ne porte ce `voice_id`. Listez le catalogue avec `GET /v2/api/voices`.</td></tr>
    <tr id="agent_knowledge_not_found"><td style={{ whiteSpace: 'nowrap' }}>`AGENT_KNOWLEDGE_NOT_FOUND`</td><td>Aucune entrée de connaissance de ce type avec cet ID pour la ligne. Listez-les avec `GET /v2/api/numbers/{number}/agent`.</td></tr>
    <tr id="agent_calendar_not_found"><td style={{ whiteSpace: 'nowrap' }}>`AGENT_CALENDAR_NOT_FOUND`</td><td>Aucun agenda avec cet ID n'est visible pour vous. Listez-les avec `GET /v2/api/calendars`.</td></tr>
    <tr id="partner_esim_not_found"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ESIM_NOT_FOUND`</td><td>Aucune eSIM avec cet ID n'a été commandée sur un compte provisionné par votre clé API. Utilisez l'`id` renvoyé par `POST /v2/api/partner/accounts/{account_id}/esims`.</td></tr>
    <tr id="partner_esim_number_not_found"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ESIM_NUMBER_NOT_FOUND`</td><td>Le numéro n'appartient pas à ce compte. Utilisez l'un des `phone_numbers` du compte, renvoyés par `GET /v2/api/partner/accounts/{id}`.</td></tr>
    <tr id="partner_esim_holder_not_found"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ESIM_HOLDER_NOT_FOUND`</td><td>L'utilisateur `holder_id` ne peut pas détenir d'eSIM pour ce numéro. Omettez `holder_id` pour que le compte en soit le titulaire.</td></tr>
    <tr id="partner_sender_id_not_found"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_SENDER_ID_NOT_FOUND`</td><td>Aucun Sender ID avec cet identifiant n'est déclaré sur ce compte. Listez-les avec `GET /v2/api/partner/accounts/{account_id}/sender_ids`.</td></tr>
    <tr id="partner_account_not_found"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ACCOUNT_NOT_FOUND`</td><td>Aucun compte avec cet ID n'a été créé par votre API key, ou le compte est désactivé. Vous ne gérez que les comptes créés par votre propre clé.</td></tr>
    <tr id="partner_account_member_not_found"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ACCOUNT_MEMBER_NOT_FOUND`</td><td>Aucun membre avec cet ID dans le workspace du compte. Listez les membres du compte avec `GET /v2/api/partner/accounts/{id}/members`.</td></tr>
    <tr id="partner_account_number_not_found"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ACCOUNT_NUMBER_NOT_FOUND`</td><td>Le compte ne détient pas lui-même ce `phone_number` : le numéro n'est pas sur le compte, ou un membre le détient. Utilisez un numéro renvoyé par `GET /v2/api/partner/accounts/{id}` qu'aucun membre de `GET /v2/api/partner/accounts/{id}/members` ne détient.</td></tr>
    <tr id="recording_not_found"><td style={{ whiteSpace: 'nowrap' }}>`RECORDING_NOT_FOUND`</td><td>L'appel n'a pas d'enregistrement, ou l'ID est celui d'un SMS (`msg-*`). Seuls les appels décrochés sur des lignes avec l'enregistrement activé en ont un.</td></tr>
    <tr id="attribute_not_found"><td style={{ whiteSpace: 'nowrap' }}>`ATTRIBUTE_NOT_FOUND`</td><td>Aucun attribut avec cette clé, ou il a été supprimé. Listez-les avec `GET /v2/api/crm/attributes` pour les personnes ou `GET /v2/api/crm/companies/attributes` pour les entreprises.</td></tr>
    <tr id="user_has_no_team"><td style={{ whiteSpace: 'nowrap' }}>`USER_HAS_NO_TEAM`</td><td>`owner_type` vaut `TEAM` mais l'utilisateur n'appartient à aucune équipe. Utilisez `USER`.</td></tr>
    <tr id="view_not_found"><td style={{ whiteSpace: 'nowrap' }}>`VIEW_NOT_FOUND`</td><td>Aucune vue avec cet ID, ou vous ne pouvez pas la voir. Listez les vues avec `GET /v2/api/crm/views`.</td></tr>
    <tr id="inbox_not_found"><td style={{ whiteSpace: 'nowrap' }}>`INBOX_NOT_FOUND`</td><td>Aucune boîte de réception avec cet ID pour cet utilisateur. Les boîtes sont personnelles : listez-les avec `GET /v2/api/inboxes`, et ajoutez `?user_id=` pour celles d'un coéquipier. Sur `GET /v2/api/conversations?inbox_id=` juste après une création, l'erreur peut être passagère et porte `retryable: true` : réessayez une fois. À la modification ou à la suppression, elle est définitive.</td></tr>
  </tbody>
</table>

## Erreurs de conflit (409)

<table>
  <thead>
    <tr><th>Code</th><th>Description</th></tr>
  </thead>
  <tbody>
    <tr id="tag_already_exists"><td style={{ whiteSpace: 'nowrap' }}>`TAG_ALREADY_EXISTS`</td><td>Ce tag est deja applique a l'element de conversation. Aucune action necessaire.</td></tr>
    <tr id="other_transaction_in_progress"><td style={{ whiteSpace: 'nowrap' }}>`OTHER_TRANSACTION_IN_PROGRESS`</td><td>Une autre operation sur cette ressource est en cours. Attendez un moment et reessayez.</td></tr>
    <tr id="number_already_assigned"><td style={{ whiteSpace: 'nowrap' }}>`NUMBER_ALREADY_ASSIGNED`</td><td>Un ou plusieurs numeros de telephone sont deja attribues a des personnes existantes. Passez `allow_duplicate_number` a `true` pour creer malgre tout, ou mettez a jour la personne existante avec `PUT /v2/api/crm/people/{id}`.</td></tr>
    <tr id="idempotency_key_reuse"><td style={{ whiteSpace: 'nowrap' }}>`IDEMPOTENCY_KEY_REUSE`</td><td>Cette cle d'idempotence a deja ete utilisee pour un endpoint ou une methode HTTP differente. Utilisez une cle unique par requete distincte. Voir [Idempotence](/fr/docs/guides/error-handling#idempotence).</td></tr>
    <tr id="thread_already_exists"><td style={{ whiteSpace: 'nowrap' }}>`THREAD_ALREADY_EXISTS`</td><td>L'élément de conversation a déjà un fil (un fil par élément). Retrouvez-le avec `GET /v2/api/threads?entity_type=...&entity_id=...` et ajoutez un commentaire avec `POST /v2/api/threads/{id}/comments`.</td></tr>
    <tr id="agent_knowledge_already_exists"><td style={{ whiteSpace: 'nowrap' }}>`AGENT_KNOWLEDGE_ALREADY_EXISTS`</td><td>La ligne utilise déjà un site web avec cette URL. Réutilisez l'entrée existante.</td></tr>
    <tr id="agent_line_not_assigned"><td style={{ whiteSpace: 'nowrap' }}>`AGENT_LINE_NOT_ASSIGNED`</td><td>Aucun numéro n'est attribué à la ligne : son réceptionniste IA ne peut ni répondre ni transférer.</td></tr>
    <tr id="attribute_key_conflict"><td style={{ whiteSpace: 'nowrap' }}>`ATTRIBUTE_KEY_CONFLICT`</td><td>Un champ ou attribut personnalisé avec cette clé existe déjà avec un autre type. Choisissez un autre label ou réutilisez l'existant.</td></tr>
    <tr id="attribute_slots_exhausted"><td style={{ whiteSpace: 'nowrap' }}>`ATTRIBUTE_SLOTS_EXHAUSTED`</td><td>Aucun emplacement libre pour les champs ou attributs personnalisés de ce type. Réutilisez-en un existant ou créez-en un avec un autre type.</td></tr>
    <tr id="attribute_managed_by_integration"><td style={{ whiteSpace: 'nowrap' }}>`ATTRIBUTE_MANAGED_BY_INTEGRATION`</td><td>L'attribut est synchronisé depuis une intégration CRM et ne peut pas être supprimé. Pour les entreprises, seuls `prompt`, `should_prompt_override` et `is_visible` peuvent changer. Un champ de personne ne peut pas être modifié du tout.</td></tr>
    <tr id="attribute_concurrent_modification"><td style={{ whiteSpace: 'nowrap' }}>`ATTRIBUTE_CONCURRENT_MODIFICATION`</td><td>Les attributs ont été modifiés en même temps. Relancez la requête.</td></tr>
    <tr id="esim_not_eligible"><td style={{ whiteSpace: 'nowrap' }}>`ESIM_NOT_ELIGIBLE`</td><td>Ce numéro ne peut pas porter d'eSIM. Créez le compte avec `number_preference.esim` à `true` pour obtenir un numéro eSIM.</td></tr>
    <tr id="esim_already_exists"><td style={{ whiteSpace: 'nowrap' }}>`ESIM_ALREADY_EXISTS`</td><td>Ce numéro a déjà une eSIM non révoquée. Consultez-la avec `GET /v2/api/partner/esims/{id}`, ou révoquez-la avec `POST /v2/api/partner/esims/{id}/revoke` pour en commander une nouvelle.</td></tr>
    <tr id="partner_esim_not_revocable"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ESIM_NOT_REVOCABLE`</td><td>L'eSIM n'est pas active : elle est encore en cours de mise en service, elle a échoué, ou elle est en cours de bascule entre le réseau et l'eSIM. Seule une eSIM `ACTIVE` peut être révoquée. Vérifiez son statut avec `GET /v2/api/partner/esims/{id}`.</td></tr>
    <tr id="partner_esim_move_in_progress"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ESIM_MOVE_IN_PROGRESS`</td><td>L'une des eSIM du membre est en cours de bascule entre le réseau et l'eSIM : le membre ne peut pas encore être retiré. Toujours `retryable: true` : réessayez dans quelques minutes.</td></tr>
    <tr id="partner_esim_move_failed"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ESIM_MOVE_FAILED`</td><td>La bascule de l'une des eSIM du membre entre le réseau et l'eSIM a échoué : elle ne peut pas être révoquée et le membre ne peut pas encore être retiré. Contactez le support Allo : l'eSIM doit être vérifiée manuellement.</td></tr>
    <tr id="partner_esim_revoked"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ESIM_REVOKED`</td><td>L'eSIM a été révoquée : son code d'activation n'est plus disponible. Pour donner une nouvelle eSIM au numéro, commandez-en une.</td></tr>
    <tr id="partner_number_has_live_esim"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_NUMBER_HAS_LIVE_ESIM`</td><td>Le `phone_number` a encore une eSIM non révoquée. Révoquez-la avec `POST /v2/api/partner/esims/{id}/revoke`, puis transférez le numéro.</td></tr>
    <tr id="esim_order_in_progress"><td style={{ whiteSpace: 'nowrap' }}>`ESIM_ORDER_IN_PROGRESS`</td><td>Une commande d'eSIM pour ce numéro est encore en cours de provisionnement. Toujours `retryable: true`. Attendez le webhook `partner.esim.ready` ou `partner.esim.failed`.</td></tr>
    <tr id="esim_order_needs_support"><td style={{ whiteSpace: 'nowrap' }}>`ESIM_ORDER_NEEDS_SUPPORT`</td><td>Une précédente commande d'eSIM pour ce numéro a été débitée sans aboutir, et le support Allo la traite. Écrivez à [partnership@themobilefirst.co](mailto:partnership@themobilefirst.co) avant de commander à nouveau.</td></tr>
    <tr id="esim_not_ready"><td style={{ whiteSpace: 'nowrap' }}>`ESIM_NOT_READY`</td><td>L'eSIM est encore en cours de provisionnement : son code d'activation ne peut pas encore être lu, ni son palier ou ses données modifiés. Toujours `retryable: true`. Attendez le webhook `partner.esim.ready`, en général 5 à 15 minutes après la commande.</td></tr>
    <tr id="esim_not_active"><td style={{ whiteSpace: 'nowrap' }}>`ESIM_NOT_ACTIVE`</td><td>L'eSIM a été supprimée, ou le numéro a une commande d'eSIM plus récente : seule la dernière eSIM du numéro peut voir son palier et ses données modifiés. Utilisez l'id de la dernière eSIM, ou commandez une nouvelle eSIM avec `POST /v2/api/partner/accounts/{account_id}/esims`.</td></tr>
    <tr id="esim_tier_change_conflict"><td style={{ whiteSpace: 'nowrap' }}>`ESIM_TIER_CHANGE_CONFLICT`</td><td>Une baisse de palier est déjà prévue pour cette eSIM, et elle ne peut pas être remplacée avant de s'appliquer. `GET /v2/api/partner/esims/{id}` la renvoie dans `scheduled_tier` et `scheduled_tier_at`. Réessayez après cette date.</td></tr>
    <tr id="esim_topup_pending"><td style={{ whiteSpace: 'nowrap' }}>`ESIM_TOPUP_PENDING`</td><td>Une autre recharge pour cette eSIM est encore en cours de paiement. Toujours `retryable: true`. Réessayez dans quelques minutes, ou renvoyez la requête précédente avec sa `Idempotency-Key` pour la reprendre.</td></tr>
    <tr id="esim_subscription_conflict"><td style={{ whiteSpace: 'nowrap' }}>`ESIM_SUBSCRIPTION_CONFLICT`</td><td>L'abonnement que vous payez pour ce compte ne peut pas être débité pour des eSIM pour le moment. Le message en donne la raison. Si `retryable` vaut `true`, réessayez dans quelques minutes. Sinon, l'abonnement doit être actif et sans résiliation en attente : écrivez à [partnership@themobilefirst.co](mailto:partnership@themobilefirst.co).</td></tr>
    <tr id="sender_id_already_exists"><td style={{ whiteSpace: 'nowrap' }}>`SENDER_ID_ALREADY_EXISTS`</td><td>Le Sender ID appartient déjà à un autre compte Allo. Un Sender ID n'appartient qu'à un seul compte : choisissez un autre nom.</td></tr>
    <tr id="max_sender_ids_reached"><td style={{ whiteSpace: 'nowrap' }}>`MAX_SENDER_IDS_REACHED`</td><td>Le compte a déjà 3 Sender ID, le maximum. Listez-les avec `GET /v2/api/partner/accounts/{account_id}/sender_ids`.</td></tr>
    <tr id="partner_account_already_exists"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ACCOUNT_ALREADY_EXISTS`</td><td>L'email ou le mobile personnel, indiqué dans `param`, appartient déjà à un compte Allo. Utilisez-en un autre.</td></tr>
    <tr id="no_number_available"><td style={{ whiteSpace: 'nowrap' }}>`NO_NUMBER_AVAILABLE`</td><td>Aucun numéro ne correspond au pays et au préfixe demandés. Rien n'est débité. Réessayez plus tard, ou demandez un autre pays ou préfixe.</td></tr>
    <tr id="regulatory_verification_required"><td style={{ whiteSpace: 'nowrap' }}>`REGULATORY_VERIFICATION_REQUIRED`</td><td>Un numéro dans ce pays demande d'abord la vérification réglementaire du compte. Rien n'est débité. Choisissez un autre pays, ou écrivez à [partnership@themobilefirst.co](mailto:partnership@themobilefirst.co).</td></tr>
    <tr id="partner_account_busy"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ACCOUNT_BUSY`</td><td>Un autre numéro ou membre est en cours d'ajout ou de retrait sur ce compte, ou le même email est en cours d'ajout ailleurs. Toujours `retryable: true` : réessayez dans quelques secondes.</td></tr>
    <tr id="idempotency_key_already_used"><td style={{ whiteSpace: 'nowrap' }}>`IDEMPOTENCY_KEY_ALREADY_USED`</td><td>Une tentative précédente sur ce compte a déjà utilisé cette `Idempotency-Key`. Vérifiez le compte avec `GET /v2/api/partner/accounts/{id}` avant de réessayer avec une nouvelle clé. Sur `POST /v2/api/partner/esims/{id}/topups`, la clé a déjà servi pour une recharge avec un autre `code` sur cette eSIM : envoyez une nouvelle `Idempotency-Key` pour une nouvelle recharge.</td></tr>
    <tr id="partner_account_deactivating"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ACCOUNT_DEACTIVATING`</td><td>Le compte est en cours de désactivation à la fin de sa période de facturation : il ne prend plus de numéros ni de membres.</td></tr>
    <tr id="partner_account_subscription_conflict"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_ACCOUNT_SUBSCRIPTION_CONFLICT`</td><td>L'abonnement du compte ne peut pas être facturé pour le moment. Si `retryable` vaut `true`, réessayez dans quelques minutes, une fois sa facture en attente réglée. Sinon, écrivez à [partnership@themobilefirst.co](mailto:partnership@themobilefirst.co).</td></tr>
    <tr id="pin_limit_reached"><td style={{ whiteSpace: 'nowrap' }}>`PIN_LIMIT_REACHED`</td><td>L'utilisateur a déjà 10 conversations épinglées. Désépinglez-en une d'abord avec `DELETE /v2/api/conversations/{contact_number}/pin`.</td></tr>
  </tbody>
</table>

## Erreurs de traitement (422)

<table>
  <thead>
    <tr><th>Code</th><th>Description</th></tr>
  </thead>
  <tbody>
    <tr id="contact_filter_too_large"><td style={{ whiteSpace: 'nowrap' }}>`CONTACT_FILTER_TOO_LARGE`</td><td>Les filtres de contacts de la boîte correspondent à trop de numéros, ou contiennent plus de 50 IDs de contacts ou 10 IDs de listes. Le `type` de l'erreur est `validation_error`. Réduisez `contact_ids` et `contact_list_ids` avec `PATCH /v2/api/inboxes/{inbox_id}`, ou listez par `allo_number` à la place.</td></tr>
  </tbody>
</table>

## Erreurs de paiement (402)

<table>
  <thead>
    <tr><th>Code</th><th>Description</th></tr>
  </thead>
  <tbody>
    <tr id="esim_payment_failed"><td style={{ whiteSpace: 'nowrap' }}>`ESIM_PAYMENT_FAILED`</td><td>Allo n'a pas pu débiter la commande d'eSIM, la montée de palier ou la recharge sur votre carte : paiement refusé, ou carte qui exige 3D Secure, impossible à valider via l'API : la tentative est annulée. Rien ne reste en attente. Mettez à jour votre carte dans le portail partenaire, puis réessayez avec la même `Idempotency-Key`. Sans carte et sans crédit prépayé suffisant, l'erreur est `PARTNER_CREDIT_INSUFFICIENT`.</td></tr>
    <tr id="partner_credit_insufficient"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_CREDIT_INSUFFICIENT`</td><td>Votre crédit prépayé ne couvre pas ce montant, et votre compte de facturation n'a pas de carte enregistrée pour payer le reste. Rien n'est créé. Rechargez votre crédit ou ajoutez une carte, puis réessayez. Si la requête portait une `Idempotency-Key`, envoyez-en une nouvelle.</td></tr>
    <tr id="insufficient_credits"><td style={{ whiteSpace: 'nowrap' }}>`INSUFFICIENT_CREDITS`</td><td>Votre équipe n'a pas assez de crédits pour envoyer ce message ou ce fax. Ajoutez des crédits, puis réessayez. Voir [Crédits](/fr/help/billing/credits).</td></tr>
    <tr id="partner_billing_failed"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_BILLING_FAILED`</td><td>Allo n'a pas pu débiter votre carte, par exemple parce qu'elle a été refusée. Rien n'est créé. Mettez à jour votre carte, puis réessayez.</td></tr>
    <tr id="partner_subscription_not_billable"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_SUBSCRIPTION_NOT_BILLABLE`</td><td>Aucun abonnement ni compte de facturation ne peut être débité pour cette requête. Écrivez à [partnership@themobilefirst.co](mailto:partnership@themobilefirst.co).</td></tr>
  </tbody>
</table>

## Erreurs de rate limit (429)

<table>
  <thead>
    <tr><th>Code</th><th>Description</th></tr>
  </thead>
  <tbody>
    <tr id="rate_limit_exceeded"><td style={{ whiteSpace: 'nowrap' }}>`RATE_LIMIT_EXCEEDED`</td><td>Rate limit par seconde depasse. Toujours `retryable: true`. Attendez `retry_after_seconds` avant de reessayer.</td></tr>
    <tr id="trial_sms_limit_reached"><td style={{ whiteSpace: 'nowrap' }}>`TRIAL_SMS_LIMIT_REACHED`</td><td>Limite quotidienne de SMS du compte d'essai atteinte. Passez a un plan superieur pour envoyer plus de messages.</td></tr>
    <tr id="sms_limit_reached"><td style={{ whiteSpace: 'nowrap' }}>`SMS_LIMIT_REACHED`</td><td>Limite quotidienne de SMS API atteinte. Attendez demain ou contactez le support pour augmenter votre limite.</td></tr>
    <tr id="daily_sms_limit_reached"><td style={{ whiteSpace: 'nowrap' }}>`DAILY_SMS_LIMIT_REACHED`</td><td>Limite quotidienne de SMS atteinte pour ce numero. Attendez demain pour envoyer plus de messages depuis ce numero.</td></tr>
  </tbody>
</table>

## Erreurs serveur (500)

<table>
  <thead>
    <tr><th>Code</th><th>Description</th></tr>
  </thead>
  <tbody>
    <tr id="internal_server_error"><td style={{ whiteSpace: 'nowrap' }}>`INTERNAL_SERVER_ERROR`</td><td>Une erreur inattendue s'est produite. Reessayez la requete. Si le probleme persiste, contactez support@withallo.com avec votre `request_id`.</td></tr>
    <tr id="agent_calendar_event_types_fetch_failed"><td style={{ whiteSpace: 'nowrap' }}>`AGENT_CALENDAR_EVENT_TYPES_FETCH_FAILED`</td><td>Le fournisseur d'agenda n'a pas pu être joint. Toujours `retryable: true`. Si le problème persiste, renouvelez la connexion de l'agenda dans l'app Allo.</td></tr>
    <tr id="esim_unavailable"><td style={{ whiteSpace: 'nowrap' }}>`ESIM_UNAVAILABLE`</td><td>Impossible de commander une eSIM, de lire son code d'activation ou de modifier son palier et ses données pour ce compte pour le moment. Le message en donne la raison. Écrivez à [partnership@themobilefirst.co](mailto:partnership@themobilefirst.co) si le problème persiste.</td></tr>
    <tr id="partner_billing_unavailable"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_BILLING_UNAVAILABLE`</td><td>La facturation est temporairement indisponible. Réessayez, avec la même `Idempotency-Key` si vous en avez envoyé une : elle reprend le même débit.</td></tr>
    <tr id="partner_number_setup_failed"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_NUMBER_SETUP_FAILED`</td><td>Le numéro n'a pas pu être configuré, et le débit a été annulé. Pas de nouvelle tentative : écrivez à [partnership@themobilefirst.co](mailto:partnership@themobilefirst.co).</td></tr>
    <tr id="partner_number_kept"><td style={{ whiteSpace: 'nowrap' }}>`PARTNER_NUMBER_KEPT`</td><td>Le numéro a été attribué mais sa configuration n'a pas abouti. Il reste sur le compte et sur sa facturation. Pas de nouvelle tentative, qui ajouterait un autre numéro : écrivez à [partnership@themobilefirst.co](mailto:partnership@themobilefirst.co) en indiquant le numéro.</td></tr>
    <tr id="recording_download_unavailable"><td style={{ whiteSpace: 'nowrap' }}>`RECORDING_DOWNLOAD_UNAVAILABLE`</td><td>Le lien de téléchargement de l'enregistrement n'a pas pu être créé. Toujours `retryable: true` : réessayez dans quelques secondes.</td></tr>
  </tbody>
</table>
