Passer au contenu principal
Le paquet communautaire n8n-nodes-famulor propose 533 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 sur n8n

Ouvrez la fiche officielle de l’intégration n8n et les instructions de configuration.

n8n-nodes-famulor sur npm

Consultez le paquet et les versions pour les instances n8n auto-hébergées.
Le code source et les notes de version du connecteur sont disponibles sur GitHub. La version 2.5.0 ajoute le champ facultatif replace_payment_id à Create Platform Custom Payment pour remplacer un lien de paiement inutilisé dans le même espace client.

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.3.0 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. À partir de la version 2.7.0, Bookings → Permanently delete bookings accepte les identifiants des réservations natives terminées ou annulées. Vérifiez les identifiants avant l’exécution. Le résultat distingue les identifiants supprimés de ceux qui ont été ignorés. À partir de la version 2.9.0, Campaigns → Launch a campaign lance une campagne en brouillon tout de suite ou à un start_at fixé. Mettez compliance_attestation à true pour confirmer que la campagne respecte toutes les lois et règles de consentement applicables à ses contacts, et reprenez sequence_hash tel quel depuis Get a campaign pour que le lancement s’arrête si la séquence d’appels a changé. Pause a campaign, Resume a campaign, Cancel a campaign’s schedule et Get campaign analytics sont aussi disponibles, ainsi que les outils d’actions d’application, les vérifications do-not-call américaines et les comptes Cal.com avec leurs types d’événements. Les nœuds Start a campaign enregistrés continuent d’envoyer une requête sans corps. 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.

Destinataires manuels existants

Les nœuds webhook enregistrés en versions 2 et 3 conservent leurs paramètres et le mode manuel. Les nouveaux nœuds d’action utilisent la version 3 ; les nouveaux déclencheurs webhook utilisent la version 4 avec enregistrement automatique. Pour migrer, ajoutez la clé API et le secret aux identifiants puis choisissez Automatic Subscription. Conservez les anciens identifiants jusqu’à la migration des workflows dépendants. Destinataires manuels existants

Workflows existants

Les nœuds webhook enregistrés en versions 2 et 3 conservent leurs paramètres et le mode manuel. Les nouveaux nœuds d’action utilisent la version 3 ; les nouveaux déclencheurs webhook utilisent la version 4 avec enregistrement automatique. Pour migrer, ajoutez la clé API et le secret aux identifiants puis choisissez Automatic Subscription. Conservez les anciens identifiants jusqu’à la migration des 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

Choix des widgets dans le thème Shopify

Avec le connecteur 2.3.0 ou ultérieur, choisissez Shopify → Read Shopify widget choices ou Shopify → Synchronize Shopify widget choices, puis la boutique liée. Ces actions font partie des 485 actions natives décrites ci-dessus. La publication publique des noms est désactivée par défaut. La synchronisation l’active explicitement et publie les noms admissibles comme données publiques de la boutique Shopify, sans demande d’autorisation Shopify supplémentaire. Les mises à jour en arrière-plan conservent ce choix. Sélectionnez le widget et enregistrez le thème dans Shopify. La synchronisation n’active aucun thème. Pour désactiver la publication, utilisez la configuration décrite dans le guide Shopify. Les deux actions nécessitent un accès propriétaire/administrateur et Assistants: Read. La lecture nécessite aussi Integrations: Read ; la synchronisation nécessite Integrations: Write. Si ces actions manquent dans votre connecteur, utilisez un nœud HTTP Request avec les mêmes identifiants Header Auth : POST n’a pas de corps. Les commandes CLI équivalentes sont famulor get-shopify-widget-picker STORE_ID et famulor synchronize-shopify-widget-picker STORE_ID. Consultez le guide Shopify pour les outils MCP et méthodes SDK correspondants. La liste des boutiques nécessite aussi Integrations: Read. Utilisez By ID si vos identifiants de synchronisation disposent uniquement du droit d’écriture sur les intégrations.

Avatars IA privés

Dans Avatars, consultez le prix, préparez le téléversement, confirmez la création avec un consentement explicite et vérifiez le statut. La création et la suppression exigent une clé API liée à un utilisateur de l’espace de travail. Envoyez les octets de la photo à l’URL signée avec un nœud HTTP Request, sans identifiants Famulor pour cet envoi. Réutilisez le même identifiant après une réponse incertaine. Le coût unique de création est distinct de l’utilisation ; une règle de recharge automatique enregistrée peut s’appliquer. Consultez Avatar IA pour le parcours API, CLI et SDK.

Abonnements webhook signés

Les nouveaux nœuds Famulor Trigger du paquet 2.3.0 utilisent l’enregistrement automatique. Ajoutez la clé API de l’espace et votre secret dans Famulor Webhook API, choisissez un événement et activez le workflow. La désactivation supprime uniquement l’abonnement de ce nœud. Les nœuds enregistrés en version 2/3 restent manuels tant que vous ne choisissez pas Automatic Subscription. Les autres destinations restent inchangées. Abonnements webhook signés

Expéditeurs d’entreprise et RCS

Le paquet communautaire 2.6.0 ou ultérieur ajoute aux SMS les demandes d’expéditeur, l’actualisation du statut, les images de marque et l’envoi depuis une connexion SMS. Les nodes Send SMS existants gardent leur numéro ; mode de distribution, contenu enrichi et texte de repli sont facultatifs. Send SMS from a connection accepte aussi un expéditeur sans numéro. Les événements SMS incluent RCS. Mettez le paquet à jour après publication ; distribution npm et approbation de l’annuaire n8n sont distinctes. À partir de la version 2.8.0, List company senders for SMS and RCS affiche les pays de destination disponibles, la suggestion de l’espace de travail et les pays dont la configuration est en attente. Renseignez un ou plusieurs codes de pays disponibles dans Countries lors de la création ou de la modification d’un brouillon. Book company sender setup peut aussi recevoir la date de mise à jour du brouillon relu afin de détecter les modifications simultanées.