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.
replace_payment_id à Create Platform Custom Payment pour remplacer un lien de paiement inutilisé dans le même espace client.
Installer et connecter
- Dans votre instance n8n auto-hébergée, ouvrez Settings → Community Nodes en tant que propriétaire ou administrateur.
- Installez n8n-nodes-famulor ou mettez le paquet existant à jour. Ce guide concerne la version 2.3.0 ou ultérieure.
- Dans Famulor, sélectionnez l’espace à automatiser et créez une clé sous Settings → API & MCP, avec uniquement les autorisations nécessaires.
- 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.
- Ajoutez une action Famulor ou un Famulor Polling Trigger et sélectionnez cet identifiant.
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.
Identifiants
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 à unstart_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 valeursnullprises 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 existantsWorkflows 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 viaGET /api/v1/calls et la CLI Famulor :
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.