Saltearse al contenido

Nexus Intake

Nexus Intake da de alta en el CRM Nexus los contactos que llegan por otros canales y registra lo que hacen. Con un solo componente trabajas con dos cosas: los contactos (leads), con sus datos, su consentimiento y la campaña de la que vienen, y los eventos de un contacto, como un formulario enviado, una descarga o la asistencia a un webinar.

Nexus se encarga del resto: quita los duplicados, guarda el consentimiento y clasifica cada contacto automáticamente.

Cuándo usarlo

  • Cada formulario de contacto de tu web debe entrar en Nexus como un lead.
  • Un chatbot o un agente de voz recoge el correo de un visitante y quieres guardarlo en el CRM.
  • Tienes una lista de contactos en una hoja de cálculo y quieres importarla sin crear duplicados.
  • Quieres que Nexus sepa que un contacto ha descargado una guía o ha asistido a un webinar.

Configuración

Necesitas una credencial Nexus con la dirección de tu Nexus (por ejemplo https://nexus.tu-empresa.com) y una clave de aplicación que empieza por nxa_live_. Consulta Credenciales.

La clave la crea un administrador de Nexus en Administración › Integraciones › Claves de API, con Nueva clave de API. Elige Web en NappAI CMS en Para qué es: incluye el permiso de Contactos. Para enviar eventos, marca también Eventos en Qué puede enviar. Al crearla, Nexus muestra la Clave de API y la Dirección de Nexus: son los dos datos de la credencial. La clave solo se muestra una vez.

CampoQué hace
Credential (obligatorio)La credencial Nexus. Rellena por ti Nexus address y Nexus API key.
ResourceCon qué trabajas: Contacts (contactos) o Events (eventos de un contacto). Por defecto, Contacts.
OperationLo que haces. La lista cambia según el Resource elegido. Ver Recursos y operaciones.
Idempotency key (avanzado)Opcional. Si repites la misma clave en menos de 24 horas, Nexus no vuelve a hacer el envío. Pon aquí el identificador de lo que entra, por ejemplo el del formulario, para que un reintento no dé de alta dos veces.

Recursos y operaciones

Contacts (contactos)

OperaciónQué haceCampos
Create ContactEnvía un lead a Nexus con sus datos, su consentimiento, la página de la que viene y su campaña.Email. Opcionales: First name, Last name, Phone, Company, Job title, Website, Message, Source, External ID, Marketing consent, Page URL, Form name, UTM (JSON) y Custom fields (JSON).
  • Message es lo que escribió la persona, hasta 4.000 caracteres.
  • Source dice de dónde viene el lead, por ejemplo web_form, nappai o chatbot. Por defecto, api.
  • External ID es el identificador del lead en el sistema del que viene.
  • Marketing consent: Not stated (por defecto) no envía nada y Nexus conserva lo que ya supiera; Yes solo si la persona ha aceptado recibir comunicaciones comerciales; No si las ha rechazado.
  • Page URL y Form name son la página y el formulario donde se rellenó.
  • UTM (JSON) son los datos de la campaña, por ejemplo {"source": "google", "medium": "cpc", "campaign": "demo"}.
  • Custom fields (JSON) son datos adicionales, por ejemplo {"plan": "pro"}, de hasta 8 KB.

Events (eventos de un contacto)

OperaciónQué haceCampos
Create EventRegistra en Nexus algo que ha hecho un contacto.Event type, y Email o External ID. Opcionales: Custom type, When y Properties (JSON).
  • Event type puede ser form_submitted (formulario enviado, por defecto), page_view (página vista), download (descarga), webinar_attended (asistencia a un webinar) o custom (uno propio).
  • Custom type solo se usa con custom: un nombre en minúsculas, por ejemplo trial_started, que se envía como custom.trial_started.
  • Email o External ID identifican al contacto: usa el mismo con el que lo enviaste.
  • When es la fecha y hora del evento, por ejemplo 2026-11-09T10:30:00Z. Si lo dejas vacío, se usa el momento actual.
  • Properties (JSON) son los detalles, por ejemplo {"file": "guia-crm.pdf"}, de hasta 4 KB.

Resultado

La salida Data devuelve la respuesta de Nexus. Al crear un contacto, Nexus contesta con su identificador de entrada (intake_id) y el estado RECEIVED: lo procesa en unos 30 segundos y, si el contacto es nuevo, lanza el evento contact.created, que puedes recoger con Nexus Webhook.

El componente admite Batch Mode, para enviar un contacto por cada elemento de una lista, y se puede conectar a un Agente como herramienta. Ver Herramientas.

Ejemplo

Una empresa quiere que cada solicitud de demo de su web entre en Nexus.

  1. El formulario llega al flujo por un Webhook Input con el nombre, el correo, la empresa, el mensaje y si la persona aceptó recibir comunicaciones.
  2. Añade Nexus Intake con el recurso Contacts y la operación Create Contact.
  3. Lleva cada dato del formulario a su campo: Email, First name, Company, Message y Marketing consent. En Source escribe web_form y en Form name, Solicitud de demo.
  4. En Idempotency key, en los ajustes avanzados, pon el identificador del envío del formulario, para que un reintento no lo dé de alta dos veces.

Buenas prácticas

  • No inventes correos ni consentimientos: el consentimiento solo es verdadero si la persona lo ha aceptado.
  • Revisa que UTM (JSON), Custom fields (JSON) y Properties (JSON) sean JSON válido. Si no, el componente se detiene con un error y no envía nada.
  • Como herramienta de un chatbot, deja que el agente rellene el correo y el nombre del visitante, y fija tú Source.

Seguridad y limitaciones

  • La clave de Nexus solo sirve para enviar datos: no puede leer el CRM. Para consultar contactos u oportunidades, usa Nexus CRM.
  • Nexus solo guarda los eventos de contactos que entraron con la misma clave y que ya están procesados. Los demás los descarta sin avisar: Nexus contesta con los eventos recibidos, no con los guardados.
  • Por eso, no envíes un evento justo después de crear el contacto en la misma ejecución: espera a que Nexus lo haya procesado.
  • Si Nexus rechaza la clave, puede estar revocada, pausada o sin el permiso necesario. Un administrador puede revisarla en Administración › Integraciones.
  • Nexus limita el número de envíos por minuto. Si lo superas, el componente te dice cuántos segundos esperar.

Componentes relacionados

  • Nexus Marketing: recursos de contenido, analítica web y auditorías SEO.
  • Nexus CRM: leer y actualizar el CRM como una persona.
  • Nexus Webhook: pone en marcha el flujo con lo que pasa en Nexus.