Erreurs
Les outils ne lèvent jamais d’exception. Un appel refusé renvoie isError: true avec une phrase simple que votre assistant peut vous lire, plus un code et, quand il suffit d’attendre, retry_after_seconds.
| gap | Trop tôt après l’action précédente sur ce compte (rythme humain), ou plafond de la minute atteint. Attendez retry_after_seconds. |
| limit | Limite quotidienne ou hebdomadaire atteinte, ou note d’invitation trop longue. Remise à zéro à minuit UTC / le lundi. |
| cooldown | Le réseau a limité le compte ; les actions reprennent après le délai indiqué. |
| plan | Aucun abonnement actif. pluggzy_billing fournit un lien pour s’abonner. |
| account | Le compte doit être reconnecté. connect_account fournit un lien de reconnexion. |
| no_account | Aucun compte connecté pour l’instant. connect_account fournit un lien. |
| permission | Cette app ou clé API n’a pas le droit d’effectuer cette action. Reconnectez l’app avec l’autorisation nécessaire, ou utilisez une autre clé. |
| invalid_post | Le post enfreint les règles du canal (longueur, médias, champ obligatoire). Rien n’a été envoyé. |
| unsupported | L’action n’est pas disponible sur ce canal (une recherche sur WhatsApp, une nouvelle conversation sur Instagram Business). |
| trial_limit · seat_limit · plan_inactive | connect_account ne peut pas ajouter de compte pour le moment (nombre maximal de comptes atteint, offre, ou nombre de comptes inclus dans l’offre). |
Exemple de refusisError
{ "error": "Daily message limit reached (75/day). Resets at 00:00 UTC, in 7 h.", "code": "limit", "retry_after_seconds": 25200 }