Skip to main content
POST
Appliquer un modèle d’automatisation
API Famulor 1.0 (héritée). Cette page concerne uniquement Famulor 1.0 (app.famulor.de) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la référence API Famulor 2.0.
Ce point de terminaison crée une automatisation à partir d’un modèle (voir Lister les modèles d’automatisation), exécute un véritable test et — pour les modèles déclenchés par un événement d’assistant — associe l’automatisation à l’assistant une fois le test réussi. Il renvoie la même enveloppe que Créer une automatisation.
Les modèles marqués side_effects: true envoient réellement des messages ou démarrent réellement des appels pendant leur exécution de test — les appliquer nécessite confirm_side_effects: true, et le test cible les valeurs réelles que vous avez fournies. N’appliquez jamais un modèle avec des valeurs d’exemple ou devinées.

Paramètres de chemin

string
requis
La clé du modèle (depuis Lister les modèles d’automatisation). Une clé inconnue renvoie une 404.

Corps de la requête

object
Les paramètres du modèle sous forme de paires clé-valeur — consultez la liste params du modèle pour savoir ce que chacun requiert. Les paramètres obligatoires manquants renvoient une 422 (missing_params) listant exactement ce qui est nécessaire. 64 Ko max.
integer
L’assistant auquel l’automatisation résultante est associée. Requis pour les modèles avec requires_assistant: true.
string
Un nom personnalisé pour l’automatisation (255 caractères max.) ; utilise par défaut le nom du modèle
boolean
Requis (true) pour les modèles marqués side_effects: true

Réponse

L’enveloppe de Créer une automatisation : automation_id, webhook_url (pour les modèles déclenchés par webhook tels que lead-intake-webhook et ceux de recherche en cours d’appel ; null pour les modèles déclenchés par un événement d’assistant), status (active / active_untested / test_failed), test (run_status + résultats par étape), response, binding. Renvoie 201 lorsque l’automatisation est active, 200 lorsque son exécution de test a échoué. Un modèle dont l’exécution de test se met en pause à une étape Delay (par ex. post-call-callback) rapporte run_status: "PAUSED" — c’est un succès, pas un échec : chaque étape avant la pause s’est exécutée, et l’exécution reprendra à l’heure cible.

Codes d’erreur (422)

Les échecs définitifs renvoient {"message": "...", "error": "<code>", "params": ...} et rien n’est créé. Codes notables :