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.
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.
1En Zapier, crea un Zap y busca ConnectMachine.
2Elige un disparador o una acción de ConnectMachine y haz clic en Iniciar sesión.
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.
4Revisa los permisos que vas a conceder y haz clic en Aprobar y continuar.
5Zapier vuelve al editor de Zaps con tu cuenta de ConnectMachine conectada y lista para usar.
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
Permiso
Para qué sirve
Leer los datos de tu cuenta
Etiqueta la conexión en Zapier para que distingas unas cuentas de otras.
Leer contactos y redes
Carga registros de ejemplo para las pruebas y rellena los desplegables de contacto y de red.
Crear y actualizar contactos
Solo se usa cuando un Zap ejecuta la acción Crear contacto o Actualizar contacto.
Gestionar sus propias suscripciones de disparador
Permite 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.
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.
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.
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.
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.
Cada disparador entrega a Zapier el registro completo del contacto, así que puedes mapear cualquiera de estos campos en un paso posterior.
Campo
Qué contiene
Item ID
Un ID estable del evento, para que tu Zap nunca se ejecute dos veces por el mismo cambio.
Contact ID
El ID del contacto en ConnectMachine. Mapéalo en Actualizar contacto o guárdalo en tu otra app.
Event Type
Si el contacto se creó, se actualizó o se eliminó.
Source
De dónde vino el cambio. El valor zapier significa que lo hizo uno de tus propios Zaps.
Contact Type
Persona o empresa.
First Name, Last Name, Company, Job Title
Los campos de identidad básicos.
Label, Notes, Bio
Tu etiqueta de ConnectMachine, las notas privadas y la bio del contacto.
Primary Email, Primary Phone, Website
Los valores de contacto principales, listos para mapear en casi cualquier app.
Emails, Phones, Websites, Socials, Custom
Listas etiquetadas. Cada entrada tiene una etiqueta y un valor.
Address, Where We Met
Calle, ciudad, provincia, código postal, país y coordenadas.
Tags
Las etiquetas del contacto, incluidas las de evento.
Created At, Updated At, Deleted At
Marcas 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.
Campo
Obligatorio
Notas
Contact ID
Solo al actualizar
Elige un contacto reciente del desplegable o selecciona Personalizado para mapear un ID de un paso anterior.
Contact Type
Opcional
Persona o empresa. Por defecto, persona.
First Name
Solo al crear
Obligatorio al crear cualquier contacto.
Company
Opcional
Añade un nombre de empresa; usa el Tipo de contacto Empresa para contactos de empresa.
Last Name, Job Title, Label
Opcional
Campos de texto simple.
Notes, Bio
Opcional
Las notas son privadas de tu cuenta.
Network
Opcional
Déjalo en blanco para usar tu red por defecto.
Primary Email, Primary Phone, Website
Opcional
Actualiza el valor principal actual, o crea uno si no existe.
Emails, Phones, Websites, Socials, Custom
Opcional
Hasta cinco entradas de cada. Cada entrada necesita una etiqueta y un valor.
Address, Where We Met
Opcional
Calle, 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.
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 JSON
Tipo
Reglas
type
string
person o business. Por defecto, person al crear.
first_name, last_name
string
first_name es obligatorio al crear cualquier contacto.
company, job_title
string
Datos opcionales de empresa y cargo.
notes, bio, network_id
string
network_id debe pertenecer a la cuenta conectada.
email, phone, website
string
Valores principales; las etiquetas usan email_label, phone_label y website_label.
emails, phones, websites
array
Hasta cinco objetos { label, value } por cada tipo de valor.
socials, custom
array
Hasta cinco objetos { label, value } por cada colección.
address, where_we_met
object
Campos 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.