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.
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. |
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. |
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. |
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. |
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. |
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. |
