Integración Beyond Presence n8nAutomatiza Beyond Presence con n8n.
¿Se puede desplegar un agente de vídeo desde un flujo de trabajo? La integración Beyond Presence n8n lo permite con 3 operaciones repartidas en 3 recursos: crear un agente, leer los avatares disponibles y procesar un evento webhook. Sin trigger propio: el arranque llega de otro nodo.
Nodo comunitario Este nodo no viene con n8n: es un paquete comunitario (n8n-nodes-beyondpresence) que instalas desde Settings › Community nodes en una instancia autoalojada. npm
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Qué resuelve la integración Beyond Presence n8n?
El nodo Beyond Presence deja que un flujo despliegue agentes de vídeo, consulte los avatares disponibles en la cuenta y procese los eventos que devuelve una llamada. Son 3 operaciones sobre 3 recursos: agent.create, avatar.get y webhook.handleEvent, cada una calcada de una llamada que la API de Beyond Presence ya expone, sin ninguna capa de traducción intermedia.
Resolver el avatar en caliente. Dejar un identificador de avatar escrito a mano dentro de un nodo envejece mal. avatar.get devuelve la lista en el momento de la ejecución, el flujo se queda con el que toca y pasa su identificador al paso de creación. Dos nodos, ningún copiar y pegar, y el flujo sigue vivo cuando la cuenta suma avatares nuevos.
Un agente por mercado, no uno para todos. agent.create despliega el agente con su System Prompt, su Greeting y el valor de Language que corresponda, así que un mismo flujo puede levantar una versión en español y otra en portugués sin duplicar nada. El identificador que devuelve se guarda donde tú lleves el registro.
Convertir el final de una llamada en una acción. Beyond Presence manda sus eventos a una URL. Un nodo Webhook de n8n, o sea una dirección que un servicio externo llama en cuanto pasa algo en su lado, recibe el aviso. webhook.handleEvent lee el contenido, se queda con los call_ended y el resto del flujo continúa donde haga falta, desde un correo con Gmail hasta cualquier otro nodo como Apify.
Cuándo bajar al nodo HTTP Request. Tres operaciones son una superficie corta. Todo lo que la API de Beyond Presence expone más allá de crear un agente, consultar avatares y procesar un evento sigue siendo accesible con el nodo HTTP Request, que llama a cualquier endpoint de la API y reutiliza el mismo credential mediante la autenticación predefinida. Sin configurar nada más.
Los límites, antes de montar nada. No hay nodo trigger de Beyond Presence, de modo que un flujo alrededor de esta herramienta siempre arranca en otro sitio. Y por ser un nodo comunitario, n8n Cloud solo lo acepta una vez verificado, mientras que una instancia autoalojada lo instala desde Settings sin esperar. La Reseña n8n explica qué cambia al autoalojar, y el Curso n8n cubre credentials y expresiones desde cero.
¿Cómo se conecta Beyond Presence con n8n?
- 01
Instala el nodo comunitario
Entra en Settings, abre Community nodes e instala el paquete npm
n8n-nodes-beyondpresence, hoy en versión 0.4.0. Es un paso de instancia autoalojada: n8n Cloud solo admite nodos comunitarios verificados. Cuando termine la instalación, Beyond Presence aparece en el panel de nodos y n8n no cobra nada extra por usarlo. - 02
Guarda el credential una sola vez
Consigue una clave API en Beyond Presence siguiendo la guía oficial de
docs.bey.dev/api-key, abre el menú Credentials de n8n y guárdala ahí. Un credential es un acceso almacenado por n8n: se configura una vez y todos los flujos de la instancia lo reutilizan, sin volver a pegar la clave dentro de ningún nodo. - 03
Enlaza el nodo con el credential
Coloca un nodo Beyond Presence en el lienzo y elige el credential guardado en el desplegable de la parte superior. Selecciona el recurso, después la operación, y ejecuta el nodo sobre un solo item para ver la respuesta. Empieza por
avatar.get: no pide ningún parámetro, así que una respuesta limpia confirma que la clave funciona.
Qué sabe hacer el nodo Beyond Presence
El nodo Beyond Presence expone 3 operaciones en 3 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
Agent
1 operaciónCreate a new agent
agent.createLo que ves en n8n
Notas y casos de uso
Despliega un agente nuevo con la configuración que le pases y lo devuelve al nodo siguiente. Ningún parámetro es obligatorio, así que una llamada sin datos crea un agente con los valores por defecto.
Parámetros clave
- Avatar ID: el identificador del avatar que aparece en cámara, normalmente
{{ $json.id }}traído del paso anterior. - System Prompt: las instrucciones que sigue el agente durante la llamada.
- Language: un valor de la lista,
en,fr,es,de,pty más. - Greeting: el saludo con el que abre la conversación.
- Max Session Length (Minutes): el tope de duración de una sesión.
- Capabilities: marca
webcam_visionpara activar la visión por webcam.
Avatar
1 operaciónGet the available avatars
avatar.getLo que ves en n8n
Notas y casos de uso
Devuelve los avatares que tiene disponibles la cuenta de Beyond Presence. No hay nada que rellenar: el nodo se ejecuta tal cual y entrega la lista, lista para filtrarla por nombre o escoger uno por posición en el nodo siguiente.
Webhook
1 operaciónHandle webhook event
webhook.handleEventLo que ves en n8n
Notas y casos de uso
Procesa los eventos que Beyond Presence envía sobre una llamada, de forma que un contenido en bruto se convierte en algo sobre lo que el flujo puede decidir.
Parámetros clave
- Webhook Data: obligatorio, el contenido del evento. Con un nodo Webhook de n8n que deja los datos en la propiedad body, pasa
$JSON.body. - Event Type:
call_endedcuando termina una llamada,messagecuando se intercambia un mensaje durante la llamada, oallpara procesarlo todo. - Filter by Agent IDs: actívalo para quedarte solo con ciertos agentes.
- Agent IDs: la lista separada por comas, por ejemplo
agent_123,agent_456.
¿Necesitas ayuda para automatizar Beyond Presence con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
