Ressources · Intégration n8n

Intégration Beyond Presence n8nAutomatiser Beyond Presence avec n8n.

Un agent vidéo qui se déploie depuis un workflow, ça tient debout ? L'intégration Beyond Presence n8n repose sur 3 opérations réparties sur 3 ressources : créer un agent, lire les avatars disponibles et traiter un événement webhook. Aucun trigger côté outil : le départ vient d'ailleurs.

Nœud communautaire Ce nœud n'est pas livré avec n8n : c'est un paquet communautaire (n8n-nodes-beyondpresence) à installer depuis Settings › Community nodes sur une instance auto-hébergée. npm

Tester l'intégration Beyond Presence sur n8nVoir les 3 opérations

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert vraiment l'intégration Beyond Presence n8n ?

Le nœud Beyond Presence permet à un workflow de déployer des agents vidéo, de lire les avatars disponibles sur le compte et de traiter les événements qu'un appel renvoie. Trois opérations, trois ressources : agent.create, avatar.get et webhook.handleEvent, chacune calquée sur un appel déjà exposé par l'API Beyond Presence, sans couche de traduction supplémentaire.

Récupérer la fin d'un appel sans y penser. Beyond Presence envoie ses événements sur une URL. Un nœud Webhook de n8n, c'est-à-dire une adresse qu'un service extérieur appelle dès qu'il se passe quelque chose chez lui, reçoit le paquet. webhook.handleEvent le lit, ne garde que les call_ended, et la suite du workflow fait le reste : un résumé dans Slack pour le commercial qui suit le compte.

Choisir le visage avant de déployer. Figer un identifiant d'avatar dans un nœud, ça vieillit mal. avatar.get lit la liste au moment de l'exécution, tu gardes celui qui t'intéresse, et son identifiant part dans l'opération de création juste après. Deux nœuds, zéro copier-coller, et le workflow survit à l'arrivée de nouveaux avatars sur le compte.

Un agent par offre, pas un agent pour tout. Une nouvelle ligne arrive dans Google Sheets, le workflow la lit et agent.create déploie un agent avec son System Prompt, son Greeting et la bonne Language. L'identifiant renvoyé retourne dans la ligne d'origine : on sait toujours quel agent correspond à quelle campagne.

Quand passer par HTTP Request. Trois opérations, c'est une surface courte. Tout ce que l'API de Beyond Presence expose au-delà de la création d'agent, de la lecture des avatars et du traitement d'événement reste atteignable avec le nœud HTTP Request, qui appelle n'importe quel endpoint et réutilise le même credential via l'authentification prédéfinie. Rien de plus à configurer.

Les bornes à connaître avant de construire. Il n'existe pas de nœud trigger Beyond Presence, donc un workflow autour de cet outil démarre toujours sur autre chose. Et comme il s'agit d'un nœud communautaire, n8n Cloud ne l'accepte qu'une fois vérifié, là où une instance auto-hébergée l'installe depuis Settings sans attendre. Pour cadrer ce choix, l'Avis n8n détaille ce que change l'auto-hébergement, et la Formation n8n reprend les bases des credentials et des expressions.

Connexion

Comment brancher Beyond Presence sur n8n ?

  1. 01

    Installer le nœud communautaire

    Ouvre Settings, va dans Community nodes et installe le paquet npm n8n-nodes-beyondpresence, aujourd'hui en version 0.4.0. L'opération se fait sur une instance auto-hébergée : n8n Cloud n'accepte que les nœuds communautaires vérifiés. Une fois l'installation terminée, Beyond Presence apparaît dans le panneau des nœuds, sans coût supplémentaire côté n8n.

  2. 02

    Créer le credential une bonne fois

    Récupère une clé API côté Beyond Presence en suivant le guide officiel sur docs.bey.dev/api-key, puis ouvre le menu Credentials de n8n et enregistre-la. Un credential, c'est un accès stocké par n8n : tu le configures une fois et tous les workflows de l'instance le réutilisent, sans jamais recoller la clé dans un nœud.

  3. 03

    Relier le nœud au credential

    Pose un nœud Beyond Presence sur le canvas et sélectionne le credential enregistré dans la liste déroulante en haut du nœud. Choisis la ressource, puis l'opération, et lance le nœud sur un seul item pour voir la réponse. Commence par avatar.get : aucun paramètre à remplir, donc une réponse propre veut dire que la clé passe.

Actions

Ce que le nœud Beyond Presence sait faire

Le nœud Beyond Presence expose 3 opérations sur 3 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
RessourceCreateGetHandle Event
Agent✓
Avatar✓
Webhook✓

Agent

1 opération
01

Create a new agent

agent.create

Ce que tu vois dans n8n

Notes & cas d'usage

Déploie un nouvel agent avec la configuration transmise et le renvoie au nœud suivant. Aucun paramètre n'est obligatoire : un appel nu crée donc un agent sur les valeurs par défaut.

Paramètres clés

  • Avatar ID : l'identifiant de l'avatar affiché à l'écran, souvent {{ $json.id }} récupéré à l'étape précédente.
  • System Prompt : les consignes que l'agent suit pendant l'appel.
  • Language : une valeur de la liste, en, fr, es, de, pt et d'autres.
  • Greeting : la phrase d'accueil prononcée en ouverture.
  • Max Session Length (Minutes) : la durée maximale d'une session.
  • Capabilities : coche webcam_vision pour activer la vision par webcam.
Cas d'usage
un agent dédié par offre, avec son prompt et son accueil.

Avatar

1 opération
02

Get the available avatars

avatar.get

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les avatars disponibles sur le compte Beyond Presence. Rien à remplir : le nœud s'exécute tel quel et rend la liste, prête à être filtrée sur le nom ou choisie par position dans le nœud d'après.

Cas d'usage
alimenter un sélecteur juste avant la création, pour que l'identifiant d'avatar soit résolu à l'exécution plutôt que gelé dans le workflow. Ça sert aussi de test de connexion : si l'opération répond, le credential est bon et le nœud communautaire est bien installé sur l'instance testée.

Webhook

1 opération
03

Handle webhook event

webhook.handleEvent

Ce que tu vois dans n8n

Notes & cas d'usage

Traite les événements que Beyond Presence envoie au sujet d'un appel, pour transformer un paquet brut en quelque chose sur quoi le workflow peut brancher une condition.

Paramètres clés

  • Webhook Data : requis, le contenu de l'événement. Avec un nœud Webhook de n8n qui range les données dans la propriété body, passe $JSON.body.
  • Event Type : call_ended à la fin d'un appel, message quand un message est échangé pendant l'appel, all pour tout traiter.
  • Filter by Agent IDs : active-le pour ne garder que certains agents.
  • Agent IDs : la liste séparée par des virgules, par exemple agent_123,agent_456.
Cas d'usage
séparer les messages d'appel et les fins d'appel sur deux branches.
Besoin d'aide

Besoin d'aide pour automatiser Beyond Presence avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Beyond Presence et n8n : les questions qui reviennent

01L'intégration Beyond Presence n8n est-elle gratuite ?
Oui côté n8n, avec une condition. Beyond Presence est un nœud communautaire : il n'est pas livré avec n8n, et ce n'est pas non plus une option payante. Le paquet npm n8n-nodes-beyondpresence, en version 0.4.0, s'installe depuis Settings puis Community nodes sur une instance auto-hébergée, et n8n ne facture rien pour son usage. Seule exception, n8n Cloud n'accepte que les nœuds communautaires vérifiés, donc le chemin d'installation y dépend de ce statut. Ce que coûte Beyond Presence en tant qu'outil est une autre histoire, que cette page ne traite pas.
02Quels credentials faut-il pour Beyond Presence dans n8n ?
Une clé API, enregistrée une fois en credential. Le nœud ne propose aucun sélecteur d'authentification, donc il n'y a qu'un chemin : récupérer la clé côté Beyond Presence en suivant le guide officiel sur docs.bey.dev/api-key, puis ouvrir le menu Credentials de n8n et l'y enregistrer. Un credential vit au niveau de l'instance, ce qui veut dire que tous les workflows le voient dans la liste déroulante du nœud et qu'aucune clé ne traîne dans un paramètre. Tu le crées une fois, tu le réutilises partout, et le jour où il faut la changer, ça se fait à un seul endroit.
03Quelles limites a le nœud Beyond Presence dans n8n ?
Le nœud couvre 3 opérations sur 3 ressources, et c'est toute la surface : créer un agent, lire les avatars disponibles, traiter un événement de webhook. Le reste de ce que l'API expose n'est pas dans le nœud. Le contournement est classique en n8n : le nœud HTTP Request appelle n'importe quel endpoint de l'API et réutilise le même credential via l'authentification prédéfinie, donc un seul accès sert aux deux. Le nœud est en version 1 et le paquet en est à 0.4.0, ce qui mérite d'être su avant d'y accrocher un workflow de production.
04Beyond Presence déclenche-t-il un workflow n8n en temps réel ?
Pas tout seul, puisqu'il n'existe pas de nœud trigger Beyond Presence dans n8n. Un workflow autour de cet outil démarre donc ailleurs, et il y a trois portes d'entrée habituelles. Le Schedule Trigger se déclenche à intervalle fixe, ce qui convient aux tâches récurrentes comme préparer les agents des démos du lendemain. Un nœud Webhook de n8n fournit une URL qu'un service tiers appelle, et c'est là que l'opération de traitement d'événement prend tout son sens. Sinon, le trigger d'un autre outil lance l'exécution et Beyond Presence n'est qu'une étape de la chaîne.
05n8n ou Make pour Beyond Presence ?
Ça se joue sur l'hébergement, la maîtrise des données et le modèle de coût. Make est une plateforme d'automatisation hébergée, sans option d'auto-hébergement, facturée à l'opération : la facture suit donc le volume. n8n va dans les deux sens, en auto-hébergement avec Docker ou npm, ou sur n8n Cloud, l'offre hébergée par n8n, et un workflow se comporte pareil des deux côtés. Pour Beyond Presence en particulier, l'auto-hébergement pèse plus lourd que d'habitude, puisque c'est le seul endroit où installer un nœud communautaire depuis Settings. Les deux sont visuelles : la vraie question, c'est où doivent vivre les appels et leurs données.
Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations