ConnectMachine Documentación.

ConnectMachine es la tarjeta de visita digital y el gestor de contactos con IA, creado para quien hace networking con intención, no por inercia. Crea varias tarjetas virtuales, escanea tarjetas de papel en segundos y deja que tu agente de IA privado recuerde a quién conociste, cuándo y por qué importaba.

¿Es tu primera vez en ConnectMachine? Sigue estos pasos para configurar tu cuenta y hacer tu primera conexión.

1. 1Descarga la app desde la App Store o Google Play e inicia sesión con tu correo o tu teléfono.
2. 2Crea tu primera tarjeta con una plantilla. La IA completará tus datos automáticamente, o puedes rellenarlos a mano.
3. 3Añádela a Apple Wallet/Google Wallet (iOS/Android) para acceder con un toque desde la pantalla de bloqueo.
4. 4Comparte tu tarjeta por código QR, enlace y redes sociales. La otra persona no necesita la app.

Todo lo relacionado con tus tarjetas de visita digitales está en la pantalla de Tarjetas de la app de ConnectMachine. Crea tarjetas, personalízalas para distintos públicos, edita los datos, configura la marca y comparte, todo desde un mismo sitio.

Tu primera tarjeta se crea durante la configuración inicial. Puedes añadir más tarjetas cuando quieras para distintos contextos.

1. 1Abre la pantalla de Tarjetas en la app de ConnectMachine.
2. 2Toca Crear tarjeta para empezar una nueva. Puedes crear varias tarjetas para distintos contextos.
3. 3Rellena tus datos: nombre, cargo, empresa, teléfono, correo, web y enlaces sociales.
4. 4Elige el tema de la tarjeta para que encaje con tu marca o tu estilo personal.
5. 5Previsualiza y guarda. Tu tarjeta queda lista para compartir al instante.

Una sola tarjeta sirve para un uso ocasional, pero la mayoría de los profesionales gana creando más de una. Cada tarjeta puede mostrar información distinta a públicos distintos.

• Comparte el contexto adecuado: una tarjeta para un evento de pitch a inversores no debería mostrar tu número personal.
• Mantén la marca coherente: usa el mismo logo, los mismos colores y el mismo nombre de empresa en todas las tarjetas, variando solo los campos visibles.
• Actualiza una vez, sincroniza en todas partes: edita los datos compartidos de una tarjeta y todo lo que ya compartiste reflejará el cambio.

Puedes añadir tu calendario a tus tarjetas para mostrar tu disponibilidad y agendar reuniones con tus contactos.

1. 1Abre la pantalla de Tarjetas y selecciona la tarjeta a la que quieres añadir el calendario.
2. 2Toca Editar y abre la pantalla de edición para añadir el calendario
3. 3Toca el campo Calendario para introducir la URL pública de tu calendario.
4. 4Toca el botón Guardar para guardar los cambios.

La marca de la tarjeta es el aspecto y la sensación que transmite tu tarjeta de visita digital. Desde la pantalla de Tarjetas puedes personalizar los elementos visuales para que tu tarjeta encaje con tu identidad personal o de empresa.

1. 1Abre la pantalla de Tarjetas y selecciona la tarjeta a la que quieres aplicar tu marca.
2. 2Toca Editar y abre las opciones de marca o de diseño de esa tarjeta.
3. 3Actualiza tu foto de perfil, la imagen de portada, el logo o el tema de color con las opciones que aparecen en el editor.
4. 4Previsualiza la tarjeta para ver cómo queda la marca en la vista real y cómo se verá esa misma tarjeta en la página CM.
5. 5Guarda los cambios. Las novedades aparecen en el enlace de tu tarjeta, en el código QR y en el pase de Wallet.

• Foto de perfil: usa un PNG, JPG o SVG de alta resolución. (Se recomienda una proporción 1:1)
• Banner: elige una imagen ancha que se recorte bien en móvil y en escritorio. (Se recomienda una proporción 16:9)
• Logo: usa un PNG, JPG o SVG de alta resolución sin fondo o con fondo transparente.
• Colores de marca: elige un color de marca con suficiente contraste para botones y enlaces.
• Coherencia: aplica la marca a nivel de equipo para que los nuevos miembros la hereden automáticamente.

ConnectMachine te ofrece varias formas de compartir. Elige la que encaje con el momento. Quien la reciba puede ver y guardar tus datos sin descargar la app.

1. 1Abre la tarjeta que quieras compartir.
2. 2Toca Compartir y elige QR, enlace, redes sociales, correo, Apple Wallet o Google Wallet.
3. 3Confirma que está seleccionada la tarjeta correcta si tienes varias.
4. 4Deja que la guarden. Pueden añadir tus datos a sus contactos con un solo toque.

Ten tu tarjeta a un toque de distancia. Añade el widget de ConnectMachine a tu pantalla de inicio y comparte tus datos al instante, sin abrir la app.

1. 1Desde la pantalla de inicio de tu dispositivo, abre la pantalla de widgets y añade el widget de ConnectMachine.
2. 2En la app, abre cualquier tarjeta y ve a la pantalla Comparte tu tarjeta.
3. 3Toca Añadir tarjeta al widget de inicio para añadirla a tu pantalla de inicio.
4. 4Tu tarjeta ya aparece en el widget, lista para compartirla rápido desde tu pantalla de inicio.

Mantén ordenada tu lista archivando las tarjetas que no usas a menudo, o elimínalas del todo cuando ya no las necesites.

Eliminar tarjeta - Quita una tarjeta de tu lista de forma permanente.

1. 1Abre la tarjeta y ve a la pantalla Editar tarjeta.
2. 2Toca Eliminar tarjeta y confirma.

Archivar tarjeta - Archiva temporalmente una tarjeta de tu lista.

1. 1Abre la tarjeta y ve a la pantalla Editar tarjeta.
2. 2Toca Archivar tarjeta. La tarjeta pasa a tu lista de archivadas y puedes desarchivarla cuando quieras.
3. 3Para ver las tarjetas archivadas, baja hasta el final de tu lista de tarjetas y toca el botón Tarjetas archivadas. Ahí se muestran todas.
4. 4Para recuperar una tarjeta, ábrela desde la lista de archivadas y toca Desarchivar para devolverla a tu lista principal.

¿Te han dado una tarjeta de papel? Apunta con la cámara y la IA de ConnectMachine la lee por ti. Nombres, cargos, teléfonos y correos se extraen y se guardan como una ficha de contacto limpia.

1. 1Abre el escáner desde la barra de navegación inferior, o añade el contacto a mano desde la pantalla de Contactos tocando el botón +.
2. 2Apunta con la cámara a la tarjeta de visita y captura la imagen.
3. 3Revisa los campos extraídos y corrige lo que la IA no haya acertado.
4. 4Guarda en tu red. El contacto se puede buscar y queda listo para notas y seguimiento.

Escanea el código QR de LinkedIn de alguien y ConnectMachine lo guarda al instante como contacto, con el enlace a su perfil y sus datos públicos enriquecidos.

1. 1Abre el escáner y apunta con la cámara al código QR de LinkedIn de la persona.
2. 2ConnectMachine la guarda como un contacto nuevo en tu red.
3. 3El contacto incluye un enlace a su perfil de LinkedIn: tócalo para abrir el perfil directamente en LinkedIn.
4. 4ConnectMachine enriquece el contacto automáticamente con datos disponibles públicamente, todo guardado junto al perfil de LinkedIn dentro del contacto.

Usa ConnectMachine directamente en WhatsApp para añadir contactos sin abrir la app. Comparte la foto de una tarjeta de visita, una nota en papel o cualquier imagen, y la IA extrae los datos y los guarda en tu cuenta de ConnectMachine.

1. 1Abre WhatsApp e inicia un chat con ConnectMachine en este número +1 (555) 748-0374.
2. 2Comparte una foto de una tarjeta de visita, una nota en papel, una acreditación de evento o cualquier imagen con datos de contacto.
3. 3Deja que la IA procese la imagen. ConnectMachine lee el contenido y crea o actualiza el contacto en tu app.
4. 4Abre la app de ConnectMachine para revisar el nuevo contacto en tu red.

Trae tus contactos actuales a ConnectMachine con unos pocos toques, estén donde estén.

¿Cómo importo contactos desde mi teléfono, Google o un archivo?

Abre el menú ⋮ (tres puntos) en la pantalla de contactos y elige Importar contactos. Puedes importar desde:

• Agenda del teléfono, la libreta de direcciones de tu dispositivo
• Cuenta de Google, tus contactos de Gmail
• Archivo CSV / VCF, un archivo de contactos que subas

¿Qué campos de contacto se importan?

ConnectMachine importa exactamente el contenido de tus contactos. Si un contacto importado tiene campos que no forman parte del formulario de contacto estándar de ConnectMachine, esos campos extra se conservan y se muestran en el contacto, y puedes editarlos o eliminarlos.

¿Cómo asigno las columnas del CSV al importar contactos?

Cuando importas un archivo CSV, ConnectMachine muestra una pantalla de asignación de campos para que emparejes las columnas de tu archivo con los campos correspondientes de ConnectMachine y todo quede bien organizado.

¿Has conocido a varias personas en el mismo sitio? ConnectMachine te ayuda a mantenerlas juntas. Cuando escaneas más de dos contactos en la misma ubicación, aparece automáticamente una hoja de evento para que los agrupes.

1. 1Escanea contactos como siempre. Tras más de dos escaneos en la misma ubicación, la hoja de evento se abre automáticamente.
2. 2Añade un evento (por ejemplo, un congreso, un meetup o una cena).
3. 3Los contactos que escaneaste quedan agrupados bajo ese evento.
4. 4Más adelante, podrás encontrar rápidamente a todas las personas que conociste allí abriendo el evento.

Una vez que los contactos están en tu red, la pantalla de detalles del contacto te ofrece varias formas de mantener el contacto.

¿Qué es la mensajería privada NetSend?

Envía mensajes de texto a otros usuarios de ConnectMachine a través de ConnectMachine NetSend.

1. 1Abre los detalles de un contacto. Si aparece un icono de chat, ese contacto está en ConnectMachine y disponible para NetSend.
2. 2Toca el icono de chat y envía tu mensaje.
3. 3El destinatario ve tu mensaje en una pantalla silenciosa. En cuanto lo lee y sale del chat, el mensaje se elimina automáticamente.

Comparte cualquier contacto como un archivo vCard (VCF).

1. 1Abre los detalles del contacto y toca el menú ⋮ (tres puntos).
2. 2Elige Compartir contacto. Se abrirá la pantalla de compartir nativa de tu teléfono.
3. 3Envía la vCard por cualquier app o canal disponible en tu dispositivo.

Contacta con alguien directamente desde su pantalla de detalles.

1. 1Abre los detalles del contacto y toca el menú ⋮ (tres puntos).
2. 2Elige hacer seguimiento por mensaje o por correo. ConnectMachine muestra un mensaje de plantilla ya preparado.
3. 3Edita la plantilla si hace falta y envíala. Solo está disponible si el contacto tiene guardado un número de móvil o un correo.

Pregunta a Concierge dentro de los contactos

Abre el asistente de IA de ConnectMachine con un solo toque, con plantillas listas para empezar rápido.

• Programar reunión, organiza una reunión con un contacto
• Presentación, redacta una presentación
• Compartir contacto, comparte los datos de un contacto
• Pregunta lo que sea, empieza una petición abierta

Transcribir reuniones

Captura tus reuniones como notas transcritas, vinculadas directamente al contacto correspondiente. La pantalla de detalles de cada contacto incluye un botón Transcribir.

1. 1Abre los detalles del contacto y toca Transcribir.
2. 2Si aún no hay ninguna grabación adjunta, ConnectMachine inicia una grabación nueva y la vincula a este contacto.
3. 3Si ya hay una grabación adjunta, al tocar el botón se abre esa grabación.
4. 4En ambos casos, se te lleva a la pantalla de Notas, donde están la grabación y su transcripción.

A veces, una nota de voz rápida es la forma más fácil de recordar una conversación. Al guardar un contacto puedes adjuntar una nota de voz que te ayude a recordar quién es y de qué hablasteis.

1. 1Mientras guardas un contacto, toca Añadir nota de voz.
2. 2Graba tu nota, cualquier cosa que te ayude a recordar a la persona o la conversación.
3. 3Guarda. La nota de voz queda adjunta al contacto y disponible cada vez que lo abras.

Encuentra rápido a cualquiera de tu red, recuerdes su nombre, su empresa o solo dónde os conocisteis.

¿Cómo pregunto a la IA o busco en mis contactos?

En la parte superior de la pantalla de Contactos encontrarás la barra Pregunta a la IA o busca.

• Toca la barra para ver plantillas sugeridas por la IA. Al elegir una, se abre la pantalla Preguntar con esa plantilla lista para usar.
• Para buscar, simplemente escribe. ConnectMachine busca en todos los campos de tus contactos: nombre, cargo, empresa, notas y más, así puedes encontrar a cualquiera por cualquier dato.

¿Cómo ordeno mi lista de contactos?

Toca Ordenar para organizar tu lista de contactos por:

• Alfabético, de la A a la Z por nombre
• Añadidos recientemente, primero los contactos más nuevos
• Modificados recientemente, primero los actualizados más recientemente

¿Cómo filtro contactos por sector o ubicación?

Toca Filtrar para acotar tu lista por:

• Sector
• Ubicación

ConnectMachine mantiene tu lista libre de duplicados automáticamente. Comprueba si hay contactos duplicados y lo vuelve a revisar cada 24 horas, así detecta los duplicados nuevos con el tiempo.

1. 1Cuando encuentra posibles duplicados, aparece una sugerencia en la parte superior de tu lista de contactos.
2. 2Ábrela para ver los contactos duplicados sugeridos.
3. 3Fusiónalos, todos de un toque o uno a uno.
4. 4Ignóralos, todos a la vez o uno a uno.

Las redes te permiten organizar tus contactos en grupos separados, y cada red tiene su propia tarjeta. Así puedes verlas, reordenarlas y gestionarlas.

¿Cómo abro mis redes?

Abre tus redes de cualquiera de estas dos formas; ambas llevan al mismo sitio:

• Toca el botón ‹ Contactos en la parte superior de la pantalla de contactos, o
• Mantén pulsada una etiqueta de red.
• Aparecen dos opciones: Reordenar redes, para colocar tus etiquetas de red en el orden que prefieras; Gestionar redes, que abre la lista de redes, donde cada una muestra cuántos contactos contiene.

¿Qué puedo hacer en la lista de redes?

• Añadir una red nueva, toca el botón Añadir.
• Mantén pulsada una red, verás Renombrar, Exportar contactos (solo si esa red tiene contactos) y Eliminar red.
• Desliza a la derecha sobre una red, acceso rápido a Exportar contactos (si esa red tiene contactos).
• Desliza a la izquierda sobre una red, acceso rápido a Eliminar y Renombrar.

¿Cómo exporto los contactos de una red?

Cuando exportas los contactos de una red, todos los contactos de esa red se envían por correo a la dirección asociada a tu cuenta.

¿Cómo muevo un contacto a otra red?

• Un solo contacto (deslizando), desliza a la derecha sobre un contacto y toca Cambiar red.
• Un solo contacto (desde los detalles), abre el contacto y cambia su red desde dentro.
• Actualización masiva, mantén pulsada una red, selecciona varios contactos y actualízalos todos con un toque.

Exporta todos tus contactos de ConnectMachine como un archivo CSV. El archivo se envía a la dirección de correo registrada en tu cuenta, así puedes abrirlo en el móvil, en el ordenador o importarlo en otra app.

1. 1En la barra de menú inferior, toca el icono de tres puntos.
2. 2Ve a Configuración desde el menú.
3. 3Toca Exportar contactos para iniciar la exportación.
4. 4Revisa tu correo registrado para encontrar el archivo CSV cuando la exportación esté lista.

• Formato CSV: el archivo incluye tus datos de contacto en un formato estándar que puedes abrir en hojas de cálculo o herramientas de CRM.
• Solo al correo registrado: por seguridad, ConnectMachine envía la exportación a la dirección de correo vinculada a tu cuenta.
• Exportación completa de la red: el archivo incluye todos los contactos guardados en ConnectMachine.

Tu agente de IA privado que entiende tu red. Haz preguntas en lenguaje natural, recuerda a quién conociste y dónde, y lanza acciones como agendar o compartir sin rebuscar en tu lista de contactos a mano.

¿Cómo empiezo a usar AI Concierge?

Abre Pregunta a Concierge y empieza con una plantilla ya preparada o simplemente escribe tu petición en lenguaje natural:

• Programar reunión, organiza una reunión con un contacto
• Presentación, redacta una presentación
• Compartir contacto, comparte los datos de un contacto
• Pregunta lo que sea, empieza una petición abierta

¿Cómo gestiona AI Concierge las reuniones y el calendario?

Primero conecta tu cuenta de calendario. Por ahora se admiten Google Calendar y Outlook. Una vez conectada, AI Concierge puede:

• Reservar una reunión
• Mostrar tus reuniones programadas
• Modificar una reunión
• Aceptar o rechazar una reunión, y responder a las invitaciones

¿Cómo redacto presentaciones con AI Concierge?

Presenta a dos personas cualesquiera. AI Concierge redacta un correo de presentación que puedes editar y enviar.

¿Cómo gestiona AI Concierge los contactos, las tarjetas y las redes?

• Crear un contacto nuevo y actualizar uno existente
• Crear una tarjeta o una red, y actualizarlas
• Compartir un contacto con alguien

¿Cómo programo recordatorios con AI Concierge?

• Programa un recordatorio para cualquier fecha y hora, con un título concreto.
• En iOS, el recordatorio se añade a la app Recordatorios; en Android, se añade a Google Calendar.

¿Cómo exploro mi red con AI Concierge?

• Busca contactos por sector, rol, ubicación, habilidad, notas y más
• Desglosa tus contactos por sector
• Encuentra personas por el lugar donde las conociste; por ejemplo, un evento concreto
• Pregunta por cualquier contacto en lenguaje natural

Graba tus reuniones y deja que ConnectMachine escriba por ti. Cuando detienes la grabación, AI Notetaker procesa el audio y te da un resumen limpio y la transcripción completa, listos para compartir.

¿Cómo grabo y proceso una reunión?

1. 1Inicia una grabación cuando empiece tu reunión.
2. 2Cuando termines, detén la grabación.
3. 3AI Notetaker procesa el audio y genera un resumen y una transcripción.

¿Cómo comparto las notas de AI Notetaker?

Cuando termine el procesado, puedes:

• Copiar el resumen o la transcripción y enviárselo a quien quieras, o
• Compartir un enlace directo a las notas.

¿Cómo funciona la identificación de interlocutores en AI Notetaker?

• En la transcripción puedes seleccionar o deseleccionar interlocutores.
• Cuando seleccionas a un interlocutor que ya está en tu red, AI Notetaker lo vincula a ese contacto y así tus notas de reunión quedan conectadas con las personas correctas.

Los controles de marca para administradores permiten a los administradores del equipo aplicar un aspecto coherente en la tarjeta digital de cada miembro. En lugar del estilo por defecto de ConnectMachine, las tarjetas muestran el logo, el banner y los colores de tu empresa, tanto en la propia tarjeta como en los enlaces de tarjeta compartidos.

¿Qué pueden personalizar los administradores del equipo?

Los controles de marca abarcan la identidad visual que aparece en las tarjetas y en las páginas de perfil compartidas.

¿Cómo configuro la marca del equipo?

Configura la marca una sola vez desde el panel de administración. Las novedades se despliegan a todo el equipo.

1. 1Abre los ajustes de administración del equipo en ConnectMachine.
2. 2Ve a Controles de marca dentro del espacio de trabajo de tu equipo.
3. 3Sube el logo de tu empresa y el banner o la imagen de portada.
4. 4Define los colores de marca y añade los datos de la empresa.
5. 5Guarda y previsualiza la tarjeta de un miembro para confirmar el resultado.

¿Qué consejos hay para la marca del equipo?

• Logo: usa un PNG, JPG, GIF, WEBP o SVG de alta resolución sin fondo o con fondo transparente.
• Imagen de portada (banner): elige una imagen ancha que se recorte bien en móvil y en escritorio. (Se recomienda una proporción 16:9)
• Coherencia: aplica la marca a nivel de equipo para que los nuevos miembros la hereden automáticamente.
• Modificación: los miembros del equipo pueden personalizar los colores del tema, la imagen de portada, la foto de perfil y el logo en sus propias tarjetas

La configuración de dominio personalizado te permite alojar tu perfil público y los enlaces de tarjeta compartidos en un dominio de tu propiedad, como card.yourcompany.com. Quien te visite verá tu marca en la barra de direcciones, no un enlace por defecto de ConnectMachine.

¿Qué consigo con un dominio personalizado?

Un dominio personalizado hace que tus enlaces de tarjeta sean profesionales y totalmente acordes con tu marca.

¿Cómo configuro un dominio personalizado?

La mayoría de las configuraciones se completan en minutos una vez añadidos los registros DNS.

1. 1Abre los ajustes de dominio en ConnectMachine.
2. 2Introduce tu dominio, por ejemplo card.yourcompany.com.
3. 3Copia los registros DNS que aparecen en el proceso de configuración.
4. 4Añade los registros en tu proveedor de DNS o tu registrador.
5. 5Verifica y publícalo cuando ConnectMachine confirme que el dominio y el SSL están activos.

¿Cómo comparto mi tarjeta con dominio personalizado?

Después de configurar tu dominio personalizado en ConnectMachine, tu tarjeta tiene su propio enlace listo para compartir. Un error habitual es compartir solo la URL del dominio base (por ejemplo, https://connect.yourdomain.com). La URL base por sí sola no incluye el token único de la tarjeta, así que no cargará ninguna tarjeta y mostrará un error de "enlace de compartición no válido".

1. 1Abre la app de ConnectMachine.
2. 2Ve a la pantalla Comparte tu tarjeta.
3. 3Copia el enlace de la tarjeta que aparece ahí.
4. 4Ese es tu enlace listo para compartir.

• Incorrecto (solo la URL base): https://connect.yourdomain.com
• Correcto (con el token de la tarjeta): https://connect.yourdomain.com/abc123

¿Cómo configuro el DNS para un dominio personalizado?

ConnectMachine te da los valores exactos de los registros durante la configuración. La mayoría de las configuraciones usan un registro CNAME o A que apunta a nuestros servidores.

¿Qué consejos hay para los dominios personalizados?

• Subdominios: usa un subdominio como card. o me. si tu dominio raíz ya aloja un sitio web en otro sitio.
• Propagación: los cambios de DNS pueden tardar hasta 48 horas, aunque muchos proveedores se actualizan en minutos.
• SSL: espera a que termine la verificación antes de compartir la nueva URL públicamente.
• Despliegue en el equipo: una vez verificado, los enlaces de tarjeta compartidos usan tu dominio personalizado automáticamente.

Suscríbete a los eventos de contacto y ConnectMachine enviará un POST JSON a tu endpoint HTTPS cada vez que se dispare uno. Las entregas son asíncronas y se reintentan ante fallos transitorios.

¿Qué eventos de webhook se admiten?

Tres tipos de evento cubren todo el ciclo de vida del contacto.

¿Cómo creo un webhook?

1. 1Abre los ajustes de webhooks en ConnectMachine.
2. 2Añade tu endpoint HTTPS como URL de destino.
3. 3Elige los eventos a los que suscribirte.
4. 4Guarda y envía un evento de prueba desde el probador de la app.
5. 5Revisa los registros de entrega para ver estados y tiempos.

¿Cómo envío un evento de webhook de prueba?

Lanza una entrega de ejemplo de contacts.* desde los ajustes de webhooks para comprobar que tu endpoint acepta el payload y devuelve 2xx. Tu URL debe ser HTTPS, accesible públicamente y responder en menos de 10 segundos.

¿Cómo funciona la entrega de webhooks?

Cada entrega es un POST JSON con las cabeceras de abajo. Los fallos transitorios se reintentan; los registros muestran el resultado.

1. 1Correcta — Cualquier respuesta 2xx marca la entrega como entregada.
2. 2Reintentada — Los errores de red, los timeouts y los códigos 408 / 425 / 429 / 5xx se reintentan.
3. 3Fallida — La mayoría del resto de respuestas 3xx / 4xx se tratan como fallos permanentes.

• Timeout: 10 segundos.
• Reintentos: hasta 3, con 6 minutos de separación (4 intentos en total).
• Registros: incluyen status, status_code, tiempos y un cuerpo de respuesta limitado a 4096 bytes.

¿Cuál es el formato del payload de un webhook?

Los eventos de creación y actualización comparten un envoltorio que envuelve uno o varios objetos de contacto. Los eventos de borrado solo llevan IDs.

{
  "event_id": "delivery_id",
  "occurred_at": "2026-05-15T10:30:00Z",
  "source": "contact_import",
  "source_id": "import_id",
  "batch": { "index": 1, "count": 100, "max_size": 100 },
  "data": {
    "event_type": "contacts.created",
    "contacts": []
  }
}

Un ejemplo completo de entrega de contacts.created, con la referencia de campos del contacto al lado.

{
  "event_id": "delivery_id",
  "occurred_at": "2026-05-15T10:30:00Z",
  "source": "contact_import",
  "source_id": "import_id",
  "batch": { "index": 1, "count": 100, "max_size": 100 },
  "data": {
    "event_type": "contacts.created",
    "contacts": [
      {
        "id": "contact_id",
        "first_name": "John",
        "last_name": "Doe",
        "company": "Example Corp",
        "job_title": "Product Manager",
        "label": "Work",
        "notes": "Met at event",
        "primary_email": "john.doe@example.com",
        "primary_phone": "+15550101010",
        "emails": [{ "label": "Work", "value": "john.doe@example.com" }],
        "phones": [{ "label": "Mobile", "value": "+15550101010" }],
        "websites": [{ "label": "Company", "value": "https://example.com" }],
        "socials": [
          { "linkedin_url": "https://linkedin.com/in/john-doe" },
          { "github_url": "https://github.com/john-doe" }
        ],
        "custom": [{ "label": "CRM Owner", "value": "Sales" }],
        "address": {
          "formatted": "123 Market Street, San Francisco, CA, USA, 94105",
          "raw": {}
        },
        "where_we_met": {
          "formatted": "Moscone Center, San Francisco, CA, USA",
          "raw": {}
        },
        "tags": [{ "name": "Conference", "type": "event" }],
        "notetaker_sessions": [
          {
            "session_id": "session_id",
            "title": "Meeting note",
            "summary_url": "https://...",
            "audio_url": "https://...",
            "created_at": "2026-05-15T10:00:00Z",
            "updated_at": "2026-05-15T10:05:00Z"
          }
        ],
        "created_at": "2026-05-15T10:00:00Z",
        "updated_at": "2026-05-15T10:05:00Z"
      }
    ]
  }
}

El mismo envoltorio, pero contacts se sustituye por contact_ids.

{
  "event_id": "delivery_id",
  "occurred_at": "2026-05-15T10:30:00Z",
  "source": "manual",
  "source_id": "source_id",
  "data": {
    "event_type": "contacts.deleted",
    "contact_ids": ["contact_id"]
  }
}

¿Cuáles son las buenas prácticas y los consejos para resolver problemas con los webhooks?

• Devuelve un 2xx rápido: confirma primero y deja el trabajo lento para segundo plano.
• Sé idempotente: los eventos pueden reenviarse; usa X-ConnectMachine-Delivery-ID como clave.
• Tolera los campos opcionales ausentes: no todos los contactos tienen todos los campos.
• Registra event_type y delivery_id para poder hacer seguimiento.
• Mantén las respuestas pequeñas: en los registros, los cuerpos se recortan a 4096 bytes.

Automatiza flujos de trabajo de contactos en Zapier y envía los eventos de ConnectMachine a Salesforce, HubSpot, Zoho, Pipedrive o cualquier otro CRM compatible con Zapier.

Qué te ayuda a construir esta guía

Una automatización de Zapier en la que ConnectMachine envía eventos de contacto a un webhook de Zapier, Zapier lee el payload del evento y el CRM que elijas crea, actualiza o procesa el contacto automáticamente.

Antes de empezar

• Una cuenta de ConnectMachine con suscripción y con la integración por webhooks disponible.
• Una cuenta de Zapier.
• Acceso al CRM que quieras actualizar, como Salesforce, HubSpot, Zoho o Pipedrive.
• Tener claro qué evento debe iniciar el flujo: contacto creado, contacto actualizado o contacto eliminado.

Flujo de principio a fin

1. 1Crea un Zap nuevo en Zapier.
2. 2Elige Webhooks by Zapier como disparador y selecciona Catch Hook.
3. 3Copia la URL del webhook de Zapier.
4. 4Pega esa URL en ConnectMachine, en Configuración > Integración por webhooks.
5. 5Activa el evento o los eventos de ConnectMachine que quieras que reciba Zapier.
6. 6Lanza un evento de prueba desde ConnectMachine y confirma que Zapier lo recibe.
7. 7Si quieres, añade un filtro de Zapier para que el Zap solo continúe con un tipo de evento.
8. 8Elige la acción de tu CRM, mapea los campos del payload del webhook, prueba la acción y publica el Zap.

Paso 1: abre la integración por webhooks en ConnectMachine

En la app de ConnectMachine, abre Configuración y toca Integración por webhooks dentro de Integraciones.

Paso 2: crea un disparador de webhook en Zapier

En Zapier, crea un Zap nuevo. Como app disparadora, elige Webhooks by Zapier. Como evento disparador, elige Catch Hook. Así Zapier te da una URL única que puede recibir eventos de ConnectMachine.

Paso 3: copia la URL del webhook de Zapier

Una vez configurado el disparador Catch Hook, Zapier muestra una URL de webhook. Copia esa URL. Trátala como un endpoint privado, porque cualquiera que la tenga puede enviar datos al Zap.

Paso 4: añade la URL del endpoint en ConnectMachine

Pega la URL del webhook de Zapier en el campo URL del endpoint de ConnectMachine. Activa la integración por webhooks y luego habilita los eventos que quieras enviar.

• Crear contacto envía contacts.created cuando se añade un contacto.
• Actualizar contacto envía contacts.updated cuando cambia un contacto.
• Eliminar contacto envía contacts.deleted cuando se elimina un contacto.

Paso 5: envía un evento de prueba a Zapier

Cuando la URL esté guardada y haya un evento activado, crea, actualiza o elimina un contacto en ConnectMachine para generar un evento de webhook. Vuelve a Zapier y usa Test trigger o Find new records. Selecciona la petición que Zapier encontró y continúa.

Paso 6: define data como child key

En la configuración de Catch Hook, pon data en Pick off a Child Key. Así le dices a Zapier que use el cuerpo principal del evento, donde ConnectMachine envía event_type, contacts y contact_ids.

Paso 7: filtra por tipo de evento

Si el mismo hook de Zapier recibe varios tipos de evento, añade Filter by Zapier antes de la acción de tu CRM. Configura el filtro para que Event Type coincida exactamente con el evento que debe gestionar este Zap.

• Para un flujo de creación, filtra que Event Type coincida exactamente con contacts.created.
• Para un flujo de actualización, filtra que Event Type coincida exactamente con contacts.updated.
• Para un flujo de borrado, filtra que Event Type coincida exactamente con contacts.deleted.

Paso 8: elige la acción de tu CRM

Añade como siguiente paso del Zap el CRM que quieras actualizar. Las capturas usan Salesforce como ejemplo, pero el mismo patrón sirve para cualquier CRM compatible con Zapier.

Elige la acción del CRM que encaje con tu flujo. Por ejemplo, elige Crear contacto para un Zap de contacts.created. Conecta la cuenta del CRM cuando Zapier te pida la autorización.

Paso 9: mapea los campos de ConnectMachine a los campos del CRM

En la configuración de la acción del CRM, usa el selector de campos de Zapier para mapear los valores del payload del webhook en los campos del CRM. En los eventos normales de creación y actualización, los campos del contacto aparecen bajo Contacts [0].

• Mapea First Name a Contacts [0] > First Name.
• Mapea Last Name a Contacts [0] > Last Name.
• Mapea Email a Contacts [0] > Primary Email, o a Contacts [0] > Emails [0] > Value.
• Mapea Phone a Contacts [0] > Primary Phone, o a Contacts [0] > Phones [0] > Value.
• Mapea las URL sociales directamente por su clave, como linkedin_url o github_url.

Paso 10: prueba y publica

Usa el paso Test de Zapier para enviar el contacto de ejemplo a tu CRM. Confirma que el registro del CRM es correcto y publica el Zap.

Supervisa las entregas en ConnectMachine

ConnectMachine muestra las entregas de webhook recientes con códigos de estado, número de intentos, payloads de petición y cuerpos de respuesta. Una respuesta 200 significa que Zapier aceptó el evento. Las entregas fallidas conviene revisarlas desde el cuerpo de la respuesta y reintentarlas una vez solucionado el problema del endpoint.

Referencia del payload

ConnectMachine envía JSON a la URL de Zapier. El nombre del evento está dentro de data.event_type. Los eventos de creación y actualización incluyen data.contacts. Los eventos de borrado incluyen data.contact_ids.

{
  "event_id": "delivery_id",
  "occurred_at": "2026-05-15T10:30:00Z",
  "data": {
    "event_type": "contacts.created",
    "contacts": [
      {
        "id": "uuid-1234",
        "first_name": "John",
        "last_name": "Doe",
        "company": "Acme Corp",
        "primary_email": "jondoe@mail.com",
        "primary_phone": "+14155550123",
        "emails": [{ "label": "Work", "value": "johndoe@example.com" }],
        "phones": [{ "label": "Mobile", "value": "+14155550123" }],
        "socials": [
          { "github_url": "https://github.com/johndoe" },
          { "linkedin_url": "https://linkedin.com/in/johndoe" }
        ],
        "created_at": "2026-05-15T10:00:00Z",
        "updated_at": "2026-05-15T10:05:00Z"
      }
    ]
  }
}

Los eventos de borrado usan esta estructura:

{
  "event_id": "delivery_id",
  "occurred_at": "2026-05-15T10:30:00Z",
  "data": {
    "event_type": "contacts.deleted",
    "contact_ids": ["contact_id1", "contact_id2"]
  }
}

Patrones de Zap recomendados

Solución de problemas

• Zapier no encuentra un registro de prueba: asegúrate de que la URL del endpoint en ConnectMachine coincide exactamente con la URL del hook de Zapier, de que la integración está activada y de que hay al menos un evento habilitado. Después, vuelve a crear, actualizar o eliminar un contacto.
• Cuesta mapear los campos en Zapier: pon data como child key de Catch Hook y vuelve a probar el disparador.
• Llega el evento equivocado a la acción del CRM: añade un paso Filter by Zapier y haz coincidir event_type de forma exacta.
• Solo aparece un contacto importado en el CRM: los eventos de importación pueden contener varios contactos; usa Looping by Zapier o una acción masiva del CRM si quieres procesarlos todos.
• Zapier recibe el evento pero la acción del CRM falla: revisa el resultado de la prueba de la acción del CRM y el cuerpo de la respuesta en Eventos recientes de ConnectMachine.
• Cuesta mapear las URL sociales: usa la clave específica de cada plataforma, como linkedin_url, github_url, twitter_url, facebook_url, youtube_url o instagram_url.

Seguridad y mantenimiento

• Mantén privada la URL del webhook de Zapier.
• Usa solo URL de webhook con HTTPS.
• Desactiva eventos en ConnectMachine si un Zap debe dejar de recibirlos.
• Si sustituyes la URL del hook de Zapier, actualiza la URL del endpoint en ConnectMachine.
• Revisa Eventos recientes después de publicar para confirmar que los eventos de producción llegan bien a Zapier.
• Comprueba en tu CRM o flujo de trabajo integrado que los datos aparecen correctamente.

ConnectMachine tiene un servidor MCP remoto, así que cualquier herramienta que hable Model Context Protocol puede leer y actualizar tus contactos, eventos, redes y tarjetas digitales mediante una conversación normal. No hay nada que instalar: tu herramienta se conecta por HTTPS con tu clave personal.

Qué te ayuda a construir esta guía

Una conexión funcionando entre tu herramienta de IA y tu cuenta de ConnectMachine, para que puedas pedirle que busque un contacto, añada el evento donde conociste a alguien o actualice una tarjeta digital sin salir de la herramienta en la que ya trabajas.

Antes de empezar

• Una cuenta de ConnectMachine.
• Una herramienta de IA compatible con servidores MCP remotos, como Claude, Claude Code, Cursor, VS Code, Zed, Windsurf o Cody.
• Tu clave MCP personal, que obtienes en la página de conexión en el siguiente paso.

Flujo de principio a fin

1. 1Abre la página de conexión MCP e inicia sesión con el correo de tu cuenta de ConnectMachine o con Google.
2. 2Copia tu clave MCP.
3. 3Pega la configuración de tu herramienta y sustituye YOUR_MCP_KEY por tu clave.
4. 4Reinicia la herramienta y confirma que ConnectMachine aparece en su lista de servidores MCP.
5. 5Hazle a tu asistente una pregunta sobre tu red para confirmar que la conexión funciona.

Paso 1: consigue tu clave MCP

Tu clave es un bearer token personal ligado a tu cuenta de ConnectMachine. Abre licenses.connectmachine.ai/mcp/auth e inicia sesión con el correo de tu cuenta (código de un solo uso) o con Google. La página muestra tu clave junto con fragmentos de configuración listos para las herramientas más habituales. Mantén la clave en secreto: cualquiera que la tenga puede actuar en tu cuenta.

Paso 2: conecta Claude

En Claude web y escritorio, abre Settings, luego Connectors, elige Add custom connector y pega la URL del servidor https://mcp.connectmachine.ai/mcp. No hace falta ningún archivo: Claude ejecuta por ti el flujo de inicio de sesión. Para Claude Code, crea .mcp.json en la raíz de tu proyecto con el fragmento de abajo y reinicia Claude Code.

{
  "mcpServers": {
    "connectmachine": {
      "type": "http",
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_KEY" }
    }
  }
}

Paso 3: conecta Cursor

Cursor lee los servidores MCP desde ~/.cursor/mcp.json para todos los proyectos, o desde .cursor/mcp.json dentro de un proyecto concreto. Añade el fragmento de abajo, abre Settings y confirma que ConnectMachine aparece en la lista y está activado.

{
  "mcpServers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_KEY" }
    }
  }
}

Paso 4: conecta VS Code

VS Code usa un objeto servers en lugar de mcpServers, y cada entrada declara su tipo de transporte. Pon el fragmento de abajo en .vscode/mcp.json y arranca el servidor desde el panel MCP de Copilot Chat.

{
  "servers": {
    "connectmachine": {
      "type": "http",
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_KEY" }
    }
  }
}

Paso 5: conecta Zed

Zed llama context servers a los servidores MCP y admite los remotos directamente en settings.json. Sin cabecera Authorization, Zed ejecuta el flujo de inicio de sesión estándar de MCP la primera vez que conecta, así que basta con la URL.

{
  "context_servers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp"
    }
  }
}

Qué puedes pedirle

El servidor publica 40 herramientas específicas que cubren contactos, eventos, redes, tarjetas digitales, importación y exportación, y tu perfil. Tu asistente elige la adecuada para cada petición, así que nunca tienes que nombrar una herramienta.

• Busca los contactos que conocí en el Web Summit del año pasado.
• Lista a los fundadores de mi red que trabajan en fintech.
• Añade un número de teléfono a Priya y etiquétala con el evento donde nos conocimos.
• Actualiza el cargo en mi tarjeta digital de ventas.

La referencia completa de MCP, con todas las áreas de herramientas y las reglas Premium que se aplican, está en la guía del servidor MCP.

Crea flujos de contactos instantáneos y bidireccionales sin copiar URL de webhook. Conecta una vez, elige un disparador o una acción, mapea los campos y publica tu Zap.

Flujo de principio a fin

1. 1Elige ConnectMachine en Zapier e inicia sesión una vez con Google o con un código de verificación enviado a tu correo.
2. 2Aprueba los permisos que aparecen en la página de consentimiento.
3. 3Elige un disparador (Nuevo contacto, Contacto actualizado o Contacto eliminado) o una acción (Crear contacto o Actualizar contacto).
4. 4Prueba el paso para que Zapier cargue un ejemplo real y puedas ver los campos del payload.
5. 5Mapea los campos que necesites y publica el Zap.

Disparadores y acciones

La integración incluye cinco operaciones visibles.

• Disparador Nuevo contacto — se ejecuta con contacts.created.
• Disparador Contacto actualizado — se ejecuta con contacts.updated.
• Disparador Contacto eliminado — se ejecuta con contacts.deleted e incluye la instantánea del contacto capturada antes del borrado.
• Acción Crear contacto — crea un contacto de persona o de empresa.
• Acción Actualizar contacto — actualiza un contacto existente elegido en un desplegable o mapeado como ID personalizado.

Conecta tu cuenta

Elige ConnectMachine en Zapier y haz clic en Iniciar sesión. Aprueba el acceso con Google o con un código de verificación enviado a tu correo. Solo puede conectarse una cuenta de ConnectMachine existente y con la configuración inicial terminada. Vuelve a conectarla desde Zapier si se revoca tu autorización o si una comprobación de seguridad del refresh token cierra la conexión.

Campos de Crear contacto

Elige persona o empresa y luego mapea el nombre, los apellidos, la empresa, el cargo, las notas, una red opcional, el correo principal, el teléfono principal y la web.

• Los contactos de persona requieren un nombre.
• Los contactos de empresa requieren una empresa.
• Los valores de correo y de web se validan.
• Si omites la red, ConnectMachine usa tu red por defecto.

Campos de Actualizar contacto

El ID de contacto es obligatorio. Elige un contacto reciente del desplegable o selecciona Personalizado para mapear un ID de un paso anterior del Zap. Mapea solo los campos que quieras cambiar.

• En la v1, los valores en blanco u omitidos no borran datos.
• El correo, el teléfono y la web principales actualizan el valor principal actual o crean uno.
• El contacto y la red que elijas deben pertenecer a la cuenta conectada.

Evita Zaps recursivos

Los cambios creados por las acciones de ConnectMachine emiten el disparador Nuevo contacto o Contacto actualizado como cualquier otro. Su salida contiene source=zapier y el source_id de la concesión de la conexión.

Contactos eliminados

Eliminar un contacto, hacer un borrado masivo, borrarlo todo o fusionar contactos puede activar el disparador Contacto eliminado. Zapier recibe un elemento por contacto eliminado con deleted_at y sus campos previos al borrado. La antigua integración manual por webhooks sigue enviando solo IDs en los eventos de borrado.

Privacidad y permisos

Zapier guarda las credenciales de OAuth de tu conexión. ConnectMachine solo guarda identificadores de access token y refresh tokens hasheados. La página de consentimiento nunca guarda ninguno de los dos tokens en el almacenamiento del navegador.

• user:read etiqueta la conexión.
• contacts:read alimenta los disparadores, los ejemplos y los desplegables.
• contacts:write permite Crear contacto y Actualizar contacto.
• webhooks:write deja que Zapier gestione solo sus propias suscripciones de disparador.

Referencia para desarrolladores

OAuth usa el flujo de código de autorización con PKCE S256 y refresco automático. Las suscripciones nativas usan POST /api/v1/zapier/subscriptions y DELETE /api/v1/zapier/subscriptions/:id. Los ejemplos de disparador usan GET /api/v1/zapier/trigger-samples. Las acciones usan POST /api/v1/zapier/contacts y PATCH /api/v1/zapier/contacts/:id.

Solución de problemas

Un mensaje sobre Premium significa que la cuenta ya no tiene un plan válido. Un mensaje de permisos significa que el Zap necesita reconectarse y aprobar los scopes solicitados. Si un disparador se detiene después de que Zapier devuelva un 410 Gone, vuelve a activar el Zap para que Zapier cree una suscripción nueva. Si los errores de autenticación se repiten, elimina la conexión en Zapier y vuelve a conectarla.

Recomienda ConnectMachine a tus amigos y contactos para ganar recompensas y ampliar tu propio tiempo de suscripción. Comparte tu enlace personal y controla quién se registra o se suscribe a través de él.

1. 1En la barra de menú inferior, toca el icono de tres puntos.
2. 2Ve a Configuración desde el menú.
3. 3Toca Invitar a amigos para abrir tus opciones de referidos.
4. 4Copia tu enlace de referido para compartirlo a mano, o compártelo directamente por redes sociales, mensajería, correo y otras apps.
5. 5Toca Seguimiento de referidos para ver cuántas personas se han registrado con tu enlace y cuántas han comprado una suscripción.