Saltar al contenido
Volver a los Docs de ConnectMachine

Guía de integración con Zapier

Conecta ConnectMachine con Zapier

Envía cada contacto nuevo o actualizado de ConnectMachine directamente a las apps que ya usas, y escribe contactos de vuelta desde esas apps. Esta guía cubre cómo conectar tu cuenta, los disparadores y acciones que obtienes, los campos que puedes mapear y cómo resolver los problemas más habituales.

Disparadores
Contacto nuevo, actualizado y eliminado
Acciones
Crear contacto y Actualizar contacto
Velocidad del disparador
Instantánea. Sin retardo de sondeo
Inicio de sesión
Sin contraseña ni clave de API

Actualizado en agosto de 2026

01

Antes de empezar

La app de ConnectMachine en Zapier te da tres disparadores y dos acciones para tus contactos. Los disparadores son instantáneos, así que un Zap se ejecuta a los pocos segundos de que un contacto cambie, sin esperar a un intervalo de sondeo.

Necesitarás

  • Una cuenta de ConnectMachine con la configuración inicial terminada.
  • Acceso a Zapier en tu plan de ConnectMachine: una suscripción de pago, una plaza en una licencia de organización o una prueba Premium activa.
  • Una cuenta de Zapier. El plan gratuito de Zapier incluye 100 tareas al mes, suficiente para la mayoría de Zaps de un solo paso.

02

Conecta tu cuenta

ConnectMachine se conecta a Zapier una sola vez. A partir de ahí, todos los Zaps que crees pueden reutilizar la misma conexión.

  1. 1En Zapier, crea un Zap y busca ConnectMachine.
  2. 2Elige un disparador o una acción de ConnectMachine y haz clic en Iniciar sesión.
  3. 3ConnectMachine abre una página de consentimiento. Inicia sesión con Google o con un código enviado a tu correo. Nunca se te pide una contraseña.
  4. 4Revisa los permisos que vas a conceder y haz clic en Aprobar y continuar.
  5. 5Zapier vuelve al editor de Zaps con tu cuenta de ConnectMachine conectada y lista para usar.
Página de inicio de sesión de ConnectMachine para Zapier, con opciones de código de un solo uso por correo o teléfono e inicio de sesión con Google.
Inicia sesión en tu cuenta de ConnectMachine para empezar la conexión. Los permisos que pide Zapier se detallan más abajo.

Qué estás aprobando

PermisoPara qué sirve
Leer los datos de tu cuentaEtiqueta la conexión en Zapier para que distingas unas cuentas de otras.
Leer contactos y redesCarga registros de ejemplo para las pruebas y rellena los desplegables de contacto y de red.
Crear y actualizar contactosSolo se usa cuando un Zap ejecuta la acción Crear contacto o Actualizar contacto.
Gestionar sus propias suscripciones de disparadorPermite a Zapier activar y desactivar tus disparadores. Zapier solo puede tocar las suscripciones que ha creado.
i

Desconectar

Para revocar el acceso, abre My Apps en Zapier, busca ConnectMachine y elimina la conexión. Los Zaps que la usen dejarán de ejecutarse hasta que vuelvas a conectarla. Reconecta igual si cambias de plan o si una comprobación de seguridad cierra la conexión.

03

Disparadores y acciones

Los disparadores inician un Zap cuando pasa algo en ConnectMachine. Las acciones permiten que otra app escriba en ConnectMachine.

Disparadores

Disparador

Nuevo contacto

Se añade un contacto a tu cuenta de ConnectMachine, ya sea porque escaneaste una tarjeta, la escribiste a mano o la importaste.

Disparador

Contacto actualizado

Cambia cualquier dato de un contacto existente. Zapier recibe los valores actuales del contacto, no solo el campo modificado.

Disparador

Contacto eliminado

Se elimina un contacto. Lo activan los borrados sueltos, los borrados masivos, borrarlo todo y las fusiones. Zapier recibe un elemento por contacto eliminado, con los datos capturados justo antes del borrado para que encuentres la fila correspondiente en otra app.

Acciones

Acción

Crear contacto

Añade un contacto de persona o de empresa a ConnectMachine desde otra app. El Nombre es obligatorio en todo contacto nuevo. La Empresa es opcional y puede usarse con el Tipo de contacto en Empresa. Si dejas la Red en blanco, el contacto va a tu red por defecto.

Acción

Actualizar contacto

Cambia campos de un contacto que ya existe. 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.

i

Conviene saber

Contacto eliminado es solo un disparador. No existe una acción Eliminar contacto, así que un Zap nunca puede borrar un contacto de ConnectMachine en tu nombre.

04

Crea tu primer Zap

Este recorrido mantiene sincronizadas una hoja de Google Sheets y ConnectMachine. El mismo patrón sirve para cualquiera de las apps que conecta Zapier.

1

Elige tu disparador

Añade ConnectMachine como primer paso y elige un evento de disparador. Este ejemplo usa Contacto actualizado, así que el Zap se ejecuta cada vez que cambian los datos de un contacto.

Editor de Zapier con la configuración del disparador Contacto actualizado de ConnectMachine y la cuenta conectada oculta.
2

Carga un registro de ejemplo

Haz clic en Test para cargar un contacto de ejemplo. Los ejemplos te permiten mapear campos antes de que llegue un evento real. Si no carga nada, añade o edita un contacto en ConnectMachine y prueba otra vez.

Editor de Zapier mostrando una prueba del disparador de ConnectMachine con un contacto de ejemplo disponible.
3

Mira qué te da el disparador

Despliega el ejemplo para ver todos los campos que puedes mapear en pasos posteriores: nombres, empresa, cargo, correo y teléfono principales, valores etiquetados, ubicaciones, etiquetas y marcas de tiempo.

Editor de Zapier mostrando los campos de salida del disparador de ConnectMachine para un contacto de ejemplo.
4

Mapea campos en la siguiente app

Añade tu segunda app y arrastra a ella los campos de ConnectMachine. Aquí una fila de Google Sheets alimenta la acción Actualizar contacto, así que las ediciones hechas en la hoja vuelven a ConnectMachine.

Editor de Zapier mostrando un paso de Google Sheets mapeado en la acción Actualizar contacto de ConnectMachine con datos de un contacto de ejemplo.
5

Gestiona los borrados

Usa el disparador Contacto eliminado para mantener ordenados los demás sistemas. Busca el contacto por ID o por correo en la app de destino y luego borra o archiva el registro correspondiente.

Editor de Zapier mostrando el disparador Contacto eliminado de ConnectMachine conectado a pasos de búsqueda y borrado de fila en Google Sheets.

¿Buscas ideas? La página de ConnectMachine en Zapier recoge los Zaps más populares para Salesforce, HubSpot, Slack, Gmail y Airtable. Para las dos rutas de CRM de principio a fin, con el mapeo de campos y las reglas de duplicados que necesita cada una, consulta escaneos de tarjetas a HubSpot y escaneos de tarjetas a Salesforce.

05

Campos que puedes mapear

Qué te da un disparador

Cada disparador entrega a Zapier el registro completo del contacto, así que puedes mapear cualquiera de estos campos en un paso posterior.

CampoQué contiene
Item IDUn ID estable del evento, para que tu Zap nunca se ejecute dos veces por el mismo cambio.
Contact IDEl ID del contacto en ConnectMachine. Mapéalo en Actualizar contacto o guárdalo en tu otra app.
Event TypeSi el contacto se creó, se actualizó o se eliminó.
SourceDe dónde vino el cambio. El valor zapier significa que lo hizo uno de tus propios Zaps.
Contact TypePersona o empresa.
First Name, Last Name, Company, Job TitleLos campos de identidad básicos.
Label, Notes, BioTu etiqueta de ConnectMachine, las notas privadas y la bio del contacto.
Primary Email, Primary Phone, WebsiteLos valores de contacto principales, listos para mapear en casi cualquier app.
Emails, Phones, Websites, Socials, CustomListas etiquetadas. Cada entrada tiene una etiqueta y un valor.
Address, Where We MetCalle, ciudad, provincia, código postal, país y coordenadas.
TagsLas etiquetas del contacto, incluidas las de evento.
Created At, Updated At, Deleted AtMarcas de tiempo en UTC.

Qué aceptan las acciones

Crear contacto y Actualizar contacto admiten el mismo conjunto de campos. Rellena solo los que quieras establecer.

CampoObligatorioNotas
Contact IDSolo al actualizarElige un contacto reciente del desplegable o selecciona Personalizado para mapear un ID de un paso anterior.
Contact TypeOpcionalPersona o empresa. Por defecto, persona.
First NameSolo al crearObligatorio al crear cualquier contacto.
CompanyOpcionalAñade un nombre de empresa; usa el Tipo de contacto Empresa para contactos de empresa.
Last Name, Job Title, LabelOpcionalCampos de texto simple.
Notes, BioOpcionalLas notas son privadas de tu cuenta.
NetworkOpcionalDéjalo en blanco para usar tu red por defecto.
Primary Email, Primary Phone, WebsiteOpcionalActualiza el valor principal actual, o crea uno si no existe.
Emails, Phones, Websites, Socials, CustomOpcionalHasta cinco entradas de cada. Cada entrada necesita una etiqueta y un valor.
Address, Where We MetOpcionalCalle, ciudad, provincia, código postal, país y coordenadas. Where We Met admite además un nombre de lugar.

Reglas de validación

  • Los valores de correo deben ser direcciones de correo válidas.
  • Los enlaces de web, redes sociales y mapas deben empezar por http:// o https://.
  • La latitud debe estar entre -90 y 90. La longitud debe estar entre -180 y 180.
  • Los campos en blanco se ignoran. Actualizar contacto nunca borra un valor por dejar el campo vacío.
  • El contacto y la red que elijas deben pertenecer a la cuenta de ConnectMachine conectada.

06

Evita Zaps recursivos

Cuando un Zap crea o actualiza un contacto de ConnectMachine, ese cambio activa el disparador Nuevo contacto o Contacto actualizado como cualquier otro cambio. Si el mismo Zap escucha esos disparadores, puede volver a activarse en bucle.

Cada registro de disparador lleva un campo Source. Los cambios hechos por tus propios Zaps llegan con el source zapier, así que puedes filtrarlos.

!

Añade este filtro justo después del disparador

Source  —  no coincide exactamente con  —  zapier

Solo lo necesitas en los Zaps que escriben de vuelta en ConnectMachine. Un Zap que solo envía contactos a otra app no puede entrar en bucle.

07

Solución de problemas

La mayoría de los problemas se reducen a la conexión, a tu plan o a un valor que no pasó la validación. Busca abajo tu síntoma.

Zapier dice que tu plan no incluye acceso a Zapier

Tu plan de ConnectMachine ya no cubre Zapier. Renueva tu suscripción de pago, consigue una plaza en la licencia de tu organización o empieza una prueba Premium, y vuelve a activar el Zap.

Un paso falla y pide reconectar, o dice que falta un permiso

A la conexión le falta un permiso que necesita. En Zapier, ve a My Apps, reconecta ConnectMachine y aprueba todos los permisos de la página de consentimiento.

El disparador dejó de ejecutarse y Zapier informa de un 410 Gone

La suscripción del disparador ya no existe. Desactiva y vuelve a activar el Zap para que Zapier cree una nueva.

Una acción dice que no encuentra el contacto

El ID de contacto no existe en la cuenta conectada, o el contacto se eliminó. Revisa el ID que mapeaste y confirma que estás en la cuenta de ConnectMachine correcta.

Una acción rechaza una dirección de correo o una URL

El valor mapeado no pasó la validación. Corrígelo en el origen, o añade un paso de Zapier Formatter que quite los espacios y añada el prefijo https:// antes del paso de ConnectMachine.

Has llegado al límite de Zaps activos de ConnectMachine

Desactiva un Zap de ConnectMachine que ya no uses y prueba otra vez. Zapier también reintenta por su cuenta a los 60 segundos.

La prueba del disparador no devuelve registros

Añade o edita un contacto en ConnectMachine y vuelve a hacer clic en Find new records.

El inicio de sesión falla una y otra vez

Elimina la conexión de ConnectMachine desde My Apps en Zapier y vuelve a conectarla desde cero.

08

Referencia de la API de ConnectMachine para Zapier

Esta referencia documenta todos los endpoints de la API de ConnectMachine que llama la integración nativa. Son endpoints HTTPS de producción; la integración no llama a ninguna API de sandbox, test, stage ni desarrollo.

URL base de producción
https://api.connectmachine.ai

Autenticación y scopes

La integración usa el flujo de código de autorización de OAuth 2.0 con PKCE. Los endpoints protegidos requieren Authorization: Bearer <access_token>. Zapier solicita los scopes user:read, contacts:read, contacts:write y webhooks:write.

JSON · Respuesta de token correcta
{
  "access_token": "<access-token>",
  "refresh_token": "<refresh-token>",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "user:read contacts:read contacts:write webhooks:write"
}

Endpoints

OAuth 2.0 con PKCE

GET/api/v1/oauth/authorize

Inicia la autorización y redirige el navegador a la pantalla de consentimiento de ConnectMachine.

Authorization
Punto de entrada de autorización público
Request
Query: client_id, redirect_uri, response_type=code, scope, state, code_challenge y code_challenge_method=S256.
Success
302 Found a la pantalla de consentimiento. Al aprobar, devuelve code y state a la redirect_uri registrada.
POST/api/v1/oauth/token

Intercambia un código de autorización o un refresh token por un access token.

Authorization
Autenticación del cliente OAuth
Request
Codificado como formulario. authorization_code: client_id, client_secret, code, code_verifier, redirect_uri, grant_type. refresh_token: client_id, client_secret, refresh_token, grant_type.
Success
200 OK con access_token, refresh_token, token_type=Bearer, expires_in y scope.
GET/api/v1/oauth/me

Prueba la conexión y devuelve la etiqueta de cuenta que se usa en Zapier.

Authorization
user:read
Request
Authorization: Bearer <access_token>. Sin parámetros de query ni de cuerpo.
Success
200 OK con id, email y name.

Suscripciones de disparadores instantáneos

POST/api/v1/zapier/subscriptions

Suscribe un Zap a los eventos de contacto creado, contacto actualizado o contacto eliminado.

Authorization
webhooks:write
Request
JSON: event_type y target_url. event_type es contacts.created, contacts.updated o contacts.deleted. target_url debe ser la URL HTTPS que proporciona Zapier.
Success
200 OK con id y event_type. Repetir la misma petición es idempotente.
DELETE/api/v1/zapier/subscriptions/{id}

Elimina la suscripción de disparador de la conexión autenticada.

Authorization
webhooks:write
Request
Path: el id devuelto al crear la suscripción. Sin cuerpo de petición.
Success
204 No Content.
GET/api/v1/zapier/trigger-samples

Devuelve un registro representativo para configurar y probar un disparador instantáneo.

Authorization
contacts:read
Request
Query: event_type=contacts.created, contacts.updated o contacts.deleted.
Success
200 OK con un array de un elemento que usa el esquema de entrega de webhook de más abajo.

Acciones de contacto

POST/api/v1/zapier/contacts

Crea un contacto de persona o de empresa en la cuenta conectada.

Authorization
contacts:write
Request
Mutación de contacto en JSON. first_name es obligatorio al crear cualquier contacto; company es opcional. Todos los campos admitidos se listan más abajo.
Success
201 Created con el registro de contacto normalizado.
PATCH/api/v1/zapier/contacts/{id}

Actualiza solo los campos indicados de un contacto existente de la cuenta conectada.

Authorization
contacts:write
Request
Path: el id del contacto en ConnectMachine. JSON: cualquier campo de mutación de contacto admitido. Los valores omitidos o en blanco se ignoran.
Success
200 OK con el registro de contacto normalizado.

Opciones de campo dinámicas

GET/api/v1/zapier/contact-options

Carga los contactos recientes para el desplegable de Actualizar contacto.

Authorization
contacts:read
Request
Query: page, un entero que empieza en 1. Cada página contiene hasta 50 registros.
Success
200 OK con un array de objetos con id y name.
GET/api/v1/zapier/network-options

Carga las redes para Crear contacto y Actualizar contacto.

Authorization
contacts:read
Request
Query: page, un entero que empieza en 1. Cada página contiene hasta 50 registros.
Success
200 OK con un array de objetos con id y name.

JSON de mutación de contacto

Crear contacto y Actualizar contacto aceptan JSON con los siguientes campos. Los campos desconocidos se ignoran. Los valores en blanco no borran los datos existentes.

Campo JSONTipoReglas
typestringperson o business. Por defecto, person al crear.
first_name, last_namestringfirst_name es obligatorio al crear cualquier contacto.
company, job_titlestringDatos opcionales de empresa y cargo.
notes, bio, network_idstringnetwork_id debe pertenecer a la cuenta conectada.
email, phone, websitestringValores principales; las etiquetas usan email_label, phone_label y website_label.
emails, phones, websitesarrayHasta cinco objetos { label, value } por cada tipo de valor.
socials, customarrayHasta cinco objetos { label, value } por cada colección.
address, where_we_metobjectCampos de ubicación: name, googlemap_uri, street, street2, city, state, country, postcode, latitude, longitude.

Entrega de disparadores instantáneos

ConnectMachine envía un POST HTTPS a la URL de destino de la suscripción. Los eventos de creación y actualización incluyen instantáneas del contacto actual. Los eventos de borrado incluyen contact_ids y, cuando están disponibles, las instantáneas previas al borrado en contacts. Zapier convierte cada contacto en un elemento de disparador cuyo Item ID combina los IDs de evento y de contacto.

JSON · Payload del webhook
{
  "event_id": "event_01",
  "occurred_at": "2026-08-04T12:00:00Z",
  "source": "app",
  "source_id": "contact_01",
  "data": {
    "event_type": "contacts.updated",
    "contacts": [{
      "id": "contact_01",
      "type": "person",
      "first_name": "John",
      "last_name": "Doe",
      "primary_email": "john.doe@example.com",
      "updated_at": "2026-08-04T12:00:00Z"
    }]
  }
}

Errores

Los errores usan un cuerpo JSON consistente. Una respuesta 429 incluye además una cabecera Retry-After.

JSON · Respuesta de error
{
  "error": "invalid_request",
  "error_description": "Invalid contact payload"
}
EstadoCódigosSignificado
400invalid_request, invalid_event_type, invalid_contact_type, first_name_required, invalid_email, invalid_url, invalid_website, invalid_labeled_value, too_many_values, invalid_latitude, invalid_longitude, invalid_location_url, invalid_target_urlLa petición está mal formada o un campo no pasó la validación.
401invalid_client, invalid_grant, invalid_tokenEl cliente OAuth, la concesión o el bearer token falta, ha caducado, se ha revocado o no es válido.
403insufficient_scope, onboarding_required, premium_required, forbiddenReconecta con los scopes necesarios, termina la configuración inicial o activa el acceso a Zapier para la cuenta.
404not_foundEl contacto, la cuenta o el recurso solicitado no existe.
409conflictLa petición entra en conflicto con el estado actual del recurso.
429subscription_limit, rate_limitedReintenta pasados los segundos que indica la cabecera Retry-After.
503server_error, temporarily_unavailableEl servicio no pudo completar la petición; reintenta con backoff.

¿Sigues atascado?

Envíanos el nombre de tu Zap y el error que te mostró Zapier, y le echamos un vistazo.

hi@connectmachine.ai

Volver a los Docs de ConnectMachine