Codes d'erreur

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

Code	Description
API_KEY_INVALID	L’API key fournie est invalide ou n’existe pas. Verifiez votre API key dans Parametres > API.
API_KEY_REVOKED	Cette API key a ete revoquee. Creez une nouvelle API key dans Parametres > API.
UNAUTHORIZED	L’authentification est requise. Fournissez une API key valide dans le header Authorization sous la forme Api-Key <your-key>.

​

Erreurs de permission — 403

Code	Description
API_KEY_INSUFFICIENT_SCOPE	Cette API key ne dispose pas du scope requis. Creez une nouvelle cle avec le scope necessaire. Voir la correspondance scopes-endpoints.
API_KEY_TRIAL_NOT_ALLOWED	L’acces API n’est pas disponible sur les plans d’essai. Passez a un plan payant.
FORBIDDEN	Vous n’avez pas la permission d’effectuer cette action. Contactez l’administrateur de votre workspace.
A2P_NOT_ENABLED	Le SMS A2P (Application-to-Person) n’est pas active pour ce numero. Completez l’enregistrement 10DLC dans le tableau de bord Allo.
ALLO_NUMBER_FORBIDDEN	Vous n’avez pas accès à cette ligne Allo. Listez les lignes auxquelles vous avez accès avec GET /v2/api/numbers.
NOT_NOTE_AUTHOR	Seul l’auteur de la note peut la modifier ou la supprimer.
NOT_COMMENT_AUTHOR	Seul l’auteur du commentaire peut le modifier.
AGENT_TRANSFER_RULE_MEMBER_NO_LINE_ACCESS	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.

​

Erreurs de validation — 400

Code	Description
INVALID_REQUEST_BODY	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.
MISSING_PARAMETER	Un parametre de requete obligatoire est manquant. Ajoutez le parametre nomme dans le champ param.
MISSING_HEADER	Un header obligatoire est manquant. Ajoutez le header nomme dans le champ param.
UNSUPPORTED_MEDIA_TYPE	Le Content-Type n’est pas supporte. Utilisez application/json. Retourne 415.
INVALID_PAGE_SIZE	La valeur du parametre size est invalide. Fournissez une valeur numerique entre 1 et 100.
INVALID_SEARCH_QUERY	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.
MISSING_ALLO_NUMBER	Le parametre allo_number est requis. Ajoutez-le a votre requete. Listez vos numeros avec GET /v2/api/numbers.
INVALID_DATE_RANGE	La plage de dates est invalide : from doit etre anterieur a to. Utilisez le format YYYY-MM-DD.
DATE_RANGE_TOO_WIDE	La plage de dates depasse le nombre maximum de jours autorise. Reduisez votre plage de dates.
INVALID_ITEM_ID	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.
BATCH_TOO_LARGE	La taille du lot depasse le maximum de 100. Divisez votre requete en lots de 100 ou moins.
TAGS_REQUIRED	Au moins un tag est requis. Fournissez un tableau tags non vide. Listez les tags disponibles avec GET /v2/api/tags.
INVALID_ACTION	Valeur d’action inconnue. Utilisez l’une des valeurs suivantes : READ, UNREAD, ARCHIVE, UNARCHIVE.
INVALID_GRANULARITY	Valeur de granularite inconnue. Utilisez l’une des valeurs suivantes : DAY, WEEK, MONTH.
INVALID_GROUP_BY	Valeur group_by inconnue. Consultez le champ suggestion pour les valeurs autorisees.
UNSUPPORTED_EXTEND_VALUE	Valeur extend inconnue. Actuellement supporte : transcript.
METHOD_NOT_ALLOWED	Methode HTTP non supportee pour cet endpoint. Consultez le champ suggestion pour les methodes supportees. Retourne 405.
INVALID_PHONE_FORMAT	Le numero de telephone n’est pas au format E.164 valide. Utilisez le format : +14155551234 (prefixe +, code pays, sans espaces ni tirets).
INVALID_TO_NUMBER	Le numero de destination est invalide ou injoignable. Fournissez un numero de telephone E.164 valide.
TO_NUMBER_COUNTRY_MISMATCH	Les SMS internationaux ne sont pas supportes pour ce numero. Utilisez un numero de telephone dans le meme pays que le destinataire.
NUMBER_NOT_SMS_ENABLED	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.
SENDER_ID_INBOX_CANNOT_SEND_SMS	Les boites de reception Sender ID ne peuvent pas envoyer de SMS. Utilisez un numero de telephone classique a la place.
SENDER_ID_NOT_ACTIVE	Le sender ID n’est pas actif. Activez le sender ID dans le tableau de bord Allo avant d’envoyer.
MESSAGE_NOT_COMPLIANT	Le contenu du message ne respecte pas les regles de conformite. Supprimez le contenu non autorise et reessayez.
LANDLINE_NUMBER_NOT_SUPPORTED	Le numero de destination est un fixe et ne peut pas recevoir de SMS. Fournissez un numero de telephone mobile a la place.
EMPTY_NOTE_CONTENT	Le contenu de la note ou du commentaire est vide. Fournissez une valeur content non vide.
NOTE_CONTENT_TOO_LONG	Le contenu de la note ou du commentaire dépasse le maximum de 4 000 caractères. Raccourcissez le contenu.
MISSING_ALLO_NUMBER_OR_SENDER_ID	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.
CONTACT_NOTES_UNAVAILABLE	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.
INVALID_THREAD_ENTITY_TYPE	Valeur entity_type inconnue. Utilisez l’une des valeurs suivantes : CALL, TEXT_MESSAGE, CONVERSATION_NOTE.
UNKNOWN_FIELD	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.
MISSING_FIELD	Un champ obligatoire manque, nommé dans param. Dans une collection, il porte l’index, par exemple transfer_rules[1].description.
INVALID_PHONE_NUMBER	Le numéro nommé dans param n’a pas pu être lu. Utilisez le format E.164, par exemple +33612345678.
INVALID_TIMEZONE	Ce n’est pas un identifiant de fuseau IANA. Utilisez par exemple Europe/Paris ou America/New_York.
INVALID_AGENT_LANGUAGE	Langue de réceptionniste IA inconnue. Les valeurs acceptées sont listées dans le message.
INVALID_AGENT_CAPABILITY	Clé de capacité inconnue. Utilisez SCHEDULING, CALL_TRANSFER ou WARM_TRANSFER, en majuscules.
AGENT_TRANSFER_RULE_TARGET_REQUIRED	Une règle de transfert n’a pas la cible qu’exige son type : target_number, target_member_id ou target_line_number.
AGENT_NO_FORWARDING_NUMBER	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.
AGENT_CALENDAR_TEAM_MISMATCH	L’agenda appartient à une autre équipe. Listez ceux que vous pouvez utiliser avec GET /v2/api/calendars.
AGENT_CALENDAR_EVENT_TYPES_NOT_SUPPORTED	Le fournisseur de cet agenda n’a pas de types d’événement. Associez-le à une liste vide.
INVALID_KNOWLEDGE_URL	Cette URL ne peut pas être analysée. Envoyez une URL http(s) absolue d’une page accessible publiquement.
PROMPT_SECTIONS_REQUIRED	sections est vide. Il remplace tout le prompt et doit donc porter chaque section à conserver.
INVALID_AGENT_PROMPT_SECTION	Clé de section de prompt inconnue. Les clés acceptées sont listées dans le message.
DUPLICATE_AGENT_PROMPT_SECTION	Une section de prompt apparaît plusieurs fois. Envoyez chacune au maximum une fois.
INVALID_AGENT_PROMPT_SECTION_BODY	Une section de prompt porte le mauvais corps. required_fields prend fields, toutes les autres prennent content.
MISSING_AGENT_PROMPT_SECTION	objective, personality et behaviors sont obligatoires et l’une d’elles est absente ou vide.
AGENT_PROMPT_SECTION_TOO_LONG	Une section de prompt dépasse 3 000 caractères. Raccourcissez-la.
AGENT_PROMPT_TOO_LONG	Le prompt généré depuis toutes les sections dépasse 25 000 caractères. Raccourcissez les sections.

​

Erreurs de ressource introuvable — 404

Code	Description
CONVERSATION_ITEM_NOT_FOUND	Aucun appel ou message trouve avec cet ID. Recherchez l’element avec POST /v2/api/conversations/items/search.
MEMBER_NOT_FOUND	Aucun membre d’equipe trouve avec cet ID. Listez les membres de l’equipe avec GET /v2/api/users.
TEAM_NOT_FOUND	Aucune equipe trouvee pour l’utilisateur authentifie. Verifiez la configuration de l’equipe dans le tableau de bord Allo.
USER_NOT_FOUND	Le compte utilisateur authentifie n’a pas ete trouve. Verifiez que l’API key est associee a un compte actif.
BUSINESS_NOT_FOUND	Aucun compte business trouve pour l’utilisateur authentifie. Assurez-vous que le compte a termine l’onboarding.
CALL_NOT_FOUND	Aucun appel trouve avec cet ID. Recherchez les appels avec POST /v2/api/conversations/items/search.
TEXT_MESSAGE_NOT_FOUND	Aucun message texte trouve avec cet ID. Recherchez les messages avec POST /v2/api/conversations/items/search.
PHONE_NUMBER_NOT_FOUND	Aucun numero de telephone trouve pour votre compte. Listez vos numeros avec GET /v2/api/numbers.
FROM_NUMBER_NOT_FOUND	Aucun numero de telephone Allo trouve pour votre compte. Listez vos numeros disponibles avec GET /v2/api/numbers.
TAG_NOT_FOUND	Le tag n’existe pas sur cet element de conversation. Il a peut-etre deja ete supprime.
SENDER_ID_NOT_FOUND	Aucun sender ID actif trouve. Verifiez vos sender IDs dans le tableau de bord Allo.
ENDPOINT_NOT_FOUND	Aucun endpoint trouve a cette URL. Verifiez l’URL et la methode HTTP. Voir la reference API.
PERSON_NOT_FOUND	Aucune personne trouvée avec cet ID (per-*). Recherchez des personnes avec POST /v2/api/crm/people/search.
NOTE_NOT_FOUND	Aucune note trouvée avec cet ID. Listez les notes d’une conversation avec GET /v2/api/conversations/{contact_number}/notes.
THREAD_NOT_FOUND	Aucun fil trouvé avec cet ID. Retrouvez le fil d’un élément avec GET /v2/api/threads?entity_type=...&entity_id=....
THREAD_COMMENT_NOT_FOUND	Aucun commentaire de fil trouvé avec cet ID. Récupérez le fil avec GET /v2/api/threads/{id} pour voir ses commentaires.
AGENT_VOICE_NOT_FOUND	Aucune voix ne porte ce voice_id. Listez le catalogue avec GET /v2/api/voices.
AGENT_KNOWLEDGE_NOT_FOUND	Aucune entrée de connaissance avec cet ID sur le réceptionniste IA de la ligne. Listez-les avec GET /v2/api/numbers/{number}/agent.
AGENT_CALENDAR_NOT_FOUND	Aucun agenda avec cet ID n’est visible pour vous. Listez-les avec GET /v2/api/calendars.

​

Erreurs de conflit — 409

Code	Description
TAG_ALREADY_EXISTS	Ce tag est deja applique a l’element de conversation. Aucune action necessaire.
OTHER_TRANSACTION_IN_PROGRESS	Une autre operation sur cette ressource est en cours. Attendez un moment et reessayez.
NUMBER_ALREADY_ASSIGNED	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}.
IDEMPOTENCY_KEY_REUSE	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.
THREAD_ALREADY_EXISTS	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.
AGENT_KNOWLEDGE_ALREADY_EXISTS	Le réceptionniste IA a déjà une entrée de connaissance pour cette URL. Réutilisez l’entrée existante.
AGENT_KNOWLEDGE_LIMIT_REACHED	Le réceptionniste IA a déjà le maximum de 5 sites web. Supprimez-en un d’abord.
AGENT_LINE_NOT_ASSIGNED	Aucun numéro n’est attribué à la ligne : son réceptionniste IA ne peut ni répondre ni transférer.

​

Erreurs de rate limit — 429

Code	Description
RATE_LIMIT_EXCEEDED	Rate limit par seconde depasse. Toujours retryable: true. Attendez retry_after_seconds avant de reessayer.
TRIAL_SMS_LIMIT_REACHED	Limite quotidienne de SMS du compte d’essai atteinte. Passez a un plan superieur pour envoyer plus de messages.
SMS_LIMIT_REACHED	Limite quotidienne de SMS API atteinte. Attendez demain ou contactez le support pour augmenter votre limite.
DAILY_SMS_LIMIT_REACHED	Limite quotidienne de SMS atteinte pour ce numero. Attendez demain pour envoyer plus de messages depuis ce numero.

​

Erreurs serveur — 500

Code	Description
INTERNAL_SERVER_ERROR	Une erreur inattendue s’est produite. Reessayez la requete. Si le probleme persiste, contactez [email protected] avec votre request_id.
AGENT_KNOWLEDGE_SCRAPE_FAILED	La page n’a pas pu être lue. Toujours retryable: true. Réessayez dans quelques secondes et vérifiez que la page est accessible publiquement.
AGENT_CALENDAR_EVENT_TYPES_FETCH_FAILED	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.