RRelancia
Référence

Limites

Les bornes numériques, règles de validation et erreurs courantes lors de la création d'une relance.

Cette page regroupe toutes les contraintes vérifiées à la validation d'un JSON de relance. Une relance qui ne respecte pas ces règles est refusée avec une liste explicite des problèmes.

Bornes numériques

ÉlémentMinimumMaximum
Nombre de blocs dans nodes1500
Nombre de liaisons dans edges01200
Longueur de name1 caractère160 caractères
Longueur de description0 caractère500 caractères
Longueur de id (bloc ou liaison)1 caractère120 caractères
Longueur de data.label1 caractère160 caractères
Longueur de data.subtitle0 caractère160 caractères
Longueur de data.channel1 caractère80 caractères
Longueur de data.description0 caractère500 caractères
Longueur de edges[i].label0 caractère120 caractères
Nombre d'entrées dans data.parameters024
Longueur d'une clé parameters1 caractère80 caractères
Longueur d'une valeur parameters0 caractère500 caractères
temperature (IA)0.01.0
max_output_tokens (IA)12000
timeout_seconds (HTTP)160

Règles de validation

Les règles suivantes sont vérifiées dans cet ordre. La première règle qui échoue interrompt la validation et le message d'erreur est affiché à l'utilisateur.

Règles structurelles

  1. La racine doit être un objet JSON valide.
  2. Le champ name est obligatoire, en texte non vide.
  3. Le champ status est obligatoire, et doit valoir draft, active ou paused.
  4. Le champ trigger_type est obligatoire, et doit valoir missed_call, shopify, prestashop, csv_import ou webhook.
  5. Le champ nodes est obligatoire, et doit être un tableau non vide.
  6. Le champ edges, s'il est présent, doit être un tableau.

Règles sur les blocs

  1. Chaque bloc doit avoir un id en texte non vide, unique dans le plan.
  2. Chaque bloc doit avoir un type parmi trigger, condition, message, action.
  3. Chaque bloc doit avoir un position avec x et y numériques.
  4. Chaque bloc doit avoir un data avec un label en texte non vide et un channel en texte non vide.
  5. Le bloc de type trigger doit correspondre au trigger_type à la racine (voir table de correspondance dans Déclencheurs).
  6. Un plan doit contenir au moins un bloc de type trigger.
  7. Le data.parameters d'un bloc, s'il est présent, doit être un objet (non un tableau) avec un maximum de 24 entrées.
  8. Toutes les valeurs de data.parameters doivent être des chaînes de texte.

Règles sur les liaisons

  1. Chaque liaison doit avoir un id en texte non vide, unique dans le plan.
  2. Chaque liaison doit référencer un source et un target existants dans le tableau nodes.
  3. Le label d'une liaison, s'il est présent, doit être un texte de 120 caractères maximum.

Erreurs courantes

Voici les erreurs les plus fréquentes et la façon de les corriger.

Le type "depart" n'est pas autorisé

Vous avez utilisé depart au lieu de trigger. Les quatre types autorisés sont : trigger, condition, message, action. Corrigez toutes les valeurs de nodes[i].type.

Le trigger_type "appel_manque" n'est pas autorisé

Vous avez utilisé appel_manque au lieu de missed_call. Les cinq trigger_type autorisés sont : missed_call, shopify, prestashop, csv_import, webhook.

id dupliqué dans nodes

Deux blocs ont le même id. Chaque bloc doit avoir un identifiant unique. Préfixez par exemple les ids : trigger-1, check-1, send-wa-1, task-1.

La source "x" n'existe pas dans nodes

Une liaison référence un source ou un target qui n'existe pas. Vérifiez l'orthographe et l'unicité des ids.

Le champ "parameters" doit être un objet

parameters doit être un objet {}, pas un tableau [], pas une chaîne, pas un nombre. Toutes les valeurs à l'intérieur doivent être des chaînes de texte.

headers_json invalide : doit être du JSON en texte

Le champ headers_json doit contenir du JSON valide, mais sous forme de texte (avec guillemets échappés). Exemple : "{\"Authorization\": \"Bearer xxxxxx\"}".

Caractère inattendu à la ligne N

Le JSON contient une virgule manquante, une accolade non fermée, ou un caractère parasite. Re-vérifiez le JSON avec un validateur externe (par exemple jq . fichier.json).

Cycle détecté

Un plan qui forme un cycle infini (A → B → A) est accepté par la validation, mais détecté à l'exécution et la relance est mise en pause. Pour éviter ce problème, ne créez pas de boucle dans les liaisons.

Au-delà des limites

Si vous dépassez la limite des 500 blocs ou des 1200 liaisons, scindez votre relance en plusieurs relances plus petites. Une relance peut en déclencher une autre via un appel HTTP à l'API d'automatisation (voir Actions : Appeler une source HTTP).

On this page