Skip to main content
Le paquet communautaire n8n-nodes-famulor propose 423 actions natives, 32 événements par interrogation et cinq choix d’événements webhook signés pour l’API actuelle des espaces de travail Famulor.

Famulor pour n8n

Instructions d’installation, versions et code source du connecteur.

​
Installer et connecter

  1. Dans votre instance n8n auto-hébergée, ouvrez Settings → Community Nodes en tant que propriétaire ou administrateur.
  2. Installez n8n-nodes-famulor ou mettez le paquet existant à jour. Ce guide concerne la version 2.1.1 ou ultérieure.
  3. Dans Famulor, sélectionnez l’espace à automatiser et créez une clé sous Settings → API & MCP, avec uniquement les autorisations nécessaires.
  4. Dans n8n, créez un identifiant Famulor API et saisissez la clé API. L’hôte est choisi automatiquement ; aucune Base URL n’est à saisir. Les hôtes déjà enregistrés restent pris en charge.
  5. Ajoutez une action Famulor ou un Famulor Polling Trigger et sélectionnez cet identifiant.
La clé détermine l’espace de travail. Famulor vérifie API Access, les autorisations, les fonctions disponibles et les crédits. Conservez la clé dans les identifiants n8n ; elle n’est affichée qu’une fois à sa création.
La fiche du répertoire n8n peut présenter une autre version du connecteur. n8n Cloud prend en charge les nœuds communautaires vérifiés ; l’installation npm est disponible sur les instances auto-hébergées. Si les opérations natives ci-dessous sont absentes, mettez le connecteur à jour lorsque cela est possible ou utilisez l’exemple HTTP Request.
Consultez le guide d’installation n8n.

​
Identifiants

Les opérations personnelles, comme Account → Get low-credit warning preferences, exigent un identifiant lié à un utilisateur. Une clé de compte de service n’est associée à aucun utilisateur, même avec toutes les autorisations. Gérez les alertes personnelles dans les paramètres Famulor lorsque vous utilisez une telle clé. Account → Get current credential affiche le type d’identifiant et l’espace.

​
Actions natives

Ajoutez Famulor, choisissez Resource → Operation et remplissez les champs obligatoires. Les opérations couvrent assistants, appels, campagnes, contacts, numéros, SMS, conversations, connaissances, réservations, outils, automatisations, missions, voix, widgets, paramètres et administration des espaces. Pour un premier test en lecture, choisissez Account → Get current credential ou Calls → List calls. Pour la liste des appels, ajoutez Limit dans Optional Fields avec la valeur 10.
  • Les références proposent From List ou By ID. Vous pouvez utiliser les IDs des nœuds précédents.
  • Les champs facultatifs sont omis tant qu’ils ne sont pas ajoutés. Les valeurs explicites false, 0, tableaux vides, textes vides et valeurs null prises en charge sont conservées.
  • Les listes renvoient un item n8n par enregistrement. Utilisez limit et offset pour les pages suivantes. Les aperçus audio renvoient des données binaires.
  • Chaque item d’entrée exécute une requête. Les écritures ne sont pas automatiquement répétées. Calls → Start an outbound call, les SMS, les achats et les autres écritures effectuent des opérations réelles et peuvent consommer des crédits.

​
Déclencheurs par interrogation

Ajoutez Famulor Polling Trigger, puis choisissez l’identifiant Famulor API, l’événement et la fréquence. Les événements de prospects de campagne exigent aussi un ID de campagne. Les 32 choix couvrent appels, conversations, contacts, campagnes et prospects, assistants, numéros, connaissances, outils, automatisations, missions, segments, exclusions, réservations et rappels. Utilisez Phone Call Completed pour les appels terminés et Conversation Completed pour les conversations de messagerie terminées. La première interrogation active établit un état initial sans émettre les anciens enregistrements. Les tests manuels renvoient des exemples récents sans modifier cet état. Un appel déjà en cours à l’activation peut encore émettre son événement de fin lorsqu’il se termine. L’interrogation vérifie les enregistrements et états observés. Une transition entre deux interrogations peut être manquée. Les sources temporelles relisent une fenêtre de dix minutes et éliminent les doublons ; les enregistrements visibles plus tard peuvent être manqués. Utilisez les IDs d’événement ou de ressource pour éviter les écritures répétées. Les grands ensembles nécessitent davantage de lectures API ; une analyse échouée ou incomplète ne fait pas avancer l’état.

​
Webhooks de réservation signés

Utilisez Famulor Trigger avec les identifiants Famulor Webhook API pour les envois signés. Les choix sont booking.created, booking.cancelled, booking.rescheduled, call.completed et conversation.ended. Pour les réservations :
  1. Choisissez l’événement de réservation dans n8n et copiez la Production URL.
  2. Dans Famulor, modifiez le type de réservation et ouvrez Advanced → Webhook URL.
  3. Collez l’URL et enregistrez. Lors de la première configuration, Famulor affiche un Webhook signing secret généré. Copiez-le dans le champ Webhook Secret de l’identifiant n8n.
  4. Activez le workflow n8n. Utilisez la Test URL seulement pendant l’écoute d’un événement de test ; utilisez la Production URL pour un workflow actif.
Le déclencheur vérifie la signature avant de renvoyer les données. Une signature absente ou incorrecte renvoie HTTP 401. L’événement sélectionné doit correspondre à l’envoi. Le filtre facultatif d’assistant concerne les appels et conversations.
L’URL Automations → Call completed de l’assistant et les URLs de fin de conversation des connecteurs de messagerie envoient des événements non signés. Elles ne peuvent pas utiliser ce déclencheur signé. Utilisez les événements par interrogation ci-dessus, sauf si vous disposez déjà d’un envoi signé. Il n’existe pas de page globale Settings → Webhooks pour l’espace.
La signature seule n’empêche pas la répétition d’un événement. Dédupliquez les IDs avant les écritures suivantes. Le connecteur ne modifie jamais automatiquement les destinations webhook Famulor. Consultez le guide webhook n8n.

​
Workflows existants

Les nœuds d’action et webhook enregistrés en version 2 conservent leurs définitions et paramètres. Les nouveaux nœuds utilisent la version 3. Pour migrer, choisissez l’opération native, associez ses champs et testez avant activation. Placez le secret de signature dans Famulor Webhook API. Conservez les anciens identifiants jusqu’à la migration de tous les workflows dépendants.

​
Alternative HTTP Request

Ajoutez HTTP Request et sélectionnez Authentication → Generic Credential Type → Header Auth. Conservez la valeur de l’en-tête dans un identifiant. Utilisez ensuite le tableau data de la réponse. Cette requête lit les appels. Consultez la documentation HTTP Request n8n.

​
Résoudre les erreurs

  • 401 : vérifiez la clé API enregistrée ou le secret du déclencheur webhook.
  • 403 : vérifiez les autorisations et l’accès aux fonctions et à l’espace. Les opérations personnelles exigent aussi un identifiant utilisateur.
  • 402 : vérifiez les crédits et l’accès au forfait de l’espace.
  • Aucune sortie d’interrogation : l’état initial ignore les anciens enregistrements ; vérifiez événement et campagne.
  • Aucune sortie webhook : vérifiez URL, écoute ou workflow actif, événement et filtre d’assistant.

​
API et CLI

La même liste d’appels est disponible via GET /api/v1/calls et la CLI Famulor :
Consultez la référence API pour l’authentification et les opérations.

​
Autres intégrations