n8n-nodes-beex

Beex Node for N8N

Este paquete contiene un nodo personalizado para n8n que permite interacturar con la API de Beex Contact Center, facilitando la automatización de flujos y procesos dentro del ecosistema Beex.

Beex Contact Center es una empresa peruana que ofrece una plataforma omnicanal impulsada por inteligencia artificial para optimizar la atención al cliente, ventas, marketing y cobranzas. Su software permite automatizar procesos mediante chatbots, IVR y workflows, integrando canales como llamadas, WhatsApp, redes sociales y correo electrónico, mejorando la eficiencia operativa y la experiencia del cliente

Instalación

Instalación en n8n

Para instalar este paquete en tu instancia de n8n:

1. Ve a Settings > Community Nodes > Install a Community Nodes
2. Busca n8n-nodes-beex e instálalo
3. Reinicia o Recarga n8n

Instalación manual

Para instalar el paquete de forma manual:

cd ~/.n8n/custom
npm install n8n-nodes-beex

Credenciales

Para conectarte a Beex, necesitarás emplear un Token de Acceso que deberás solicitar al momento de formar parte del ecosistema de Beex.

En n8n, puedes configurar tu credencial mediante los siguientes campos:

• TokenApp: Tu clave API de Beex
• API URL: https://api.beexcontact.com/api/v1 (La autenticación es por Header)

Funcionalidades

El nodo Beex permite realizar las siguientes operaciones:

Clientes

• Obtener varios clients: Listar los contactos/clientes registrados en la plataforma. Se muestran de forma descendente.
  • Requiere: Fecha Inicio, Fecha Fin
  • Opcional: Limit, Offset
• Obtener varios accounts-fields: Obtener los campos de productos de un cliente.
  • Requiere: id Cliente
  • Opcional: Ninguno
• Obtener varios accounts-values: Obtener los valores de productos de un cliente.
  • Requiere: id Cliente
  • Opcional: Limit, Offset
• Obtener varios custom-fields: Obtener los campos personalizados de un cliente.
  • Requiere: id Cliente
  • Opcional: Ninguno
• Obtener varios custom-values: Obtener los valores personalizados de un cliente.
  • Requiere: id Cliente
  • Opcional: Ninguno

Empresas

• Obtener varios entities: Listar Empresas
  • Requiere: Ninguno
  • Opcional: Ninguno
• Obtener un entities: Obtener datos de una empresa
  • Requiere: Id Empresa
  • Opcional: Ninguno

Importaciones

• Obtener varios imports: Listar Grabaciones
  • Requiere: Ninguno
  • Opcional: Ninguno
• Obtener varios import errors: Lista los errores de una importacion especifica
  • Requiere: id Import
  • Opcional: Ninguno

PBX

• Obtener varios pbx: Listar Grabaciones
  • Requiere: Fecha Inicio, Fecha Fin
  • Opcional: Limit, Offset
  • Campos Adicionales: Teléfono, Empresa, Portfolio, Hora Inicio, Hora Fin, Usuario, Tipo de Marcación, Disposición.
• Descargar un pbx: Descargar Grabaciones
  • Requiere: Id CDR
  • Opcional: Ninguno

Colas

• Obtener varios queues: Listar las colas creadas en la plataforma. Se muestran de forma descendente.
  • Requiere: Ninguno
  • Opcional: ID Portfolio, Limit, Offset
• Obtener un queues: Detalle de una cola en la plataforma.
  • Requiere: Id Cola
  • Opcional: Ninguno

Reportes

• Obtener reporte daily managments: Reporte de Atención al Cliente - Gestion diaria.
  • Requiere: Id Portfolio, Año, Mes
  • Opcional: Ninguno
• Obtener reporte dropped calls: Reporte de Atención al Cliente - Llamadas abandonadas.
  • Requiere: id Portfolio, Año
  • Opcional: Ninguno
• Obtener reporte resumen: Reporte de Atención al Cliente - Resumen.
  • Requiere: Id Portfolio, Fecha
  • Opcional: Ninguno
• Obtener reporte time slot: Reporte de Atención al Cliente - Tramo Horario.
  • Requiere: Id Portfolio, ID Cola, Fecha Inicio, Fecha Fin
  • Opcional: Ninguno
• Obtener reporte users managements: Reporte de Atención al Cliente - Gestion de Usuarios.
  • Requiere: Id Portfolio, Año, Mes.
  • Opcional: Ninguno
• Obtener reporte calls: Reporte de Llamadas
  • Requiere: Fecha Inicio, Fecha Fin
  • Opcional: Limit, Offset
• Obtener reporte client managements: Obtener información de tipificaciones por cliente.
  • Requiere: Id Portfolio, Fecha Inicio, Fecha Fin
  • Opcional: Limit, Offset
• Obtener reporte forms: Reporte de Formularios.
  • Requiere: Id Portfolio, Fecha Inicio, Fecha Fin, Id Formulario.
  • Opcional: Limit, Offset.
• Obtener reporte incoming call: Reporte de llamadas entrantes.
  • Requiere: Id Portfolio, Fecha Inicio, Fecha Fin
  • Opcional: Limit, Offset
• Obtener reporte ivr survey: Reporte de IVR tipo encuesta de satisfacción.
  • Requiere: Fecha Inicio, Fecha Fin, ID IVR
  • Opcional: Limit, Offset
• Obtener reporte log acw: Tipificaciones por log ACW.
  • Requiere: Id Portfolio, Fecha Inicio, Fecha Fin, Id Empresa
  • Opcional: Id Usuario, Limit, Offset
• Obtener reporte managements by acw: Tipificaciones por ACW.
  • Requiere: Id Portfolio, Fecha Inicio, Fecha Fin
  • Opcional: Id Usuario, Limit, Offset
• Obtener reporte managements per hour: Obtener información de tipificaciones por hora.
  • Requiere: Id Portfolio, Fecha Inicio, Fecha Fin
  • Opcional: Id Usuario, Limit, Offset.
• Obtener reporte messaging tickets: Reporte de tickets de mensajeria.
  • Requiere: Fecha Inicio, Fecha Fin
  • Opcional: Limit, Offset
• Obtener reporte control pdp: Promesas de pago - Control PDP.
  • Requiere: Id Portfolio, Fecha Promesa de Pago
  • Opcional: Limit, Offset
• Obtener reporte list pdp: Promesas de pago - Listado PDP
  • Requiere: Id Portfolio, Fecha Inicio, Fecha Fin
  • Opcional: Id Usuario, Limit, Offset
• Obtener reporte ranking pdp: Promesas de pago - Ranking PDP
  • Requiere: Id Portfolio, Fecha Inicio, Fecha Fin, Tipo de Ranking.
  • Opcional: Limit, Offset
• Obtener reporte phones: Reporte de teléfonos.
  • Requiere: Id Empresa
  • Opcional: Limit, Offset
• Obtener reporte platform detailed: Tiempo en plataforma detallado.
  • Requiere: Fecha Inicio, Fecha Fin
  • Opcional: Limit, Offset
• Obtener reporte platform summarized: Tiempo en plataforma sumarizado.
  • Requiere: Fecha Inicio, Fecha Fin
  • Opcional: Ninguno
• Obtener reporte product managements: Reporte de tipificaciones por producto.
  • Requiere: Id Portfolio, Fecha Inicio, Fecha Fin
  • Opcional: Limit, Offset
• Obtener reporte products: Reporte de productos.
  • Requiere: Id Portfolio
  • Opcional: Limit, Offset
• Obtener reporte progress managements: Obtener información del avance de gestiones.
  • Requiere: Id Portfolio, Fecha Inicio, Fecha Fin
  • Opcional: Ninguno
• Obtener reporte strategies: Reporte de estrategias.
  • Requiere: Id Portfolio, Fecha Inicio, Fecha Fin, Tipo de Estrategia
  • Opcional: Limit, Offset
• Obtener reporte tickets tracking: Reporte de transferencia de tickets.
  • Requiere: Id Portfolio, Fecha Inicio, Fecha Fin
  • Opcional: Id Cola, Limit, Offset

Secuencias

• Obtener varios sequences: Listar las secuencias configuradas.
  • Requiere: Ninguno
  • Opcional: Limit, Offset

Plantillas

• Obtener varios templates: Listar plantillas disponibles.
  • Requiere: Fecha Inicio, Fecha Fin
  • Opcional: ID WABA, ID Cola, Limit, Offset

Tickets

• Obtener varios tickets: Listar los tickets generados.
  • Requiere: Fecha Inicio, Fecha Fin
  • Opcional: Limit, Offset
• Obtener varios tags: Listar etiquetas de tickets.
  • Requiere: Ninguno
  • Opcional: Limit, Offset
• Obtener un message: Obtener el detalle de un mensaje de ticket.
  • Requiere: id Ticket
  • Opcional: Ninguno

Usuarios

• Obtener varios users: Listar usuarios registrados en la plataforma.
  • Requiere: Ninguno
  • Opcional: Búsqueda, Perfil, Limit, Offset

Formatos de Datos

Formato de Fechas

1. La mayoría de las funcionalidades del nodo requieren obligatoriamente una fecha de inicio y una fecha de fin.
2. El usuario puede seleccionar mediante un calendario una fecha en específica de formato AAAA-MM-DD HH:MM:SS
3. Según la necesidad del formato, el nodo internamente modificará el campo de fecha para adaptarla al formato adecuado, por ejemplo: AAAA-MM-DD o AAAA-MM-DD HH:MM

Soporte

Si experimentas percances o problemas con este nodo, por favor:

1. Verifica que el Token sea válido y posea los permisos adecuados. Recuerde solo agregar el token integro sin algún prefijo como: 'Token o Bearer'.
2. Comprueba que los formatos de datos sean los esperados (especialmente en las fechas).
3. Consulta la documentación de BeexCC para más detalles.

Licencia

MIT

Keywords

n8n-community-node-package beex

Más información

Consulta la documentación sobre la creación de nodos para obtener información detallada sobre cómo crear tus propios nodos.