01 Disparadores y acciones
La integración incluye cinco operaciones visibles.
- Nuevo contacto — contacts.created.
- Contacto actualizado — contacts.updated.
- Contacto eliminado — contacts.deleted con la copia anterior al borrado.
- Crear contacto — crea una persona o empresa.
- Actualizar contacto — usa el menú o un ID personalizado.
ImportanteContacto eliminado es solo un disparador. No existe una acción para eliminar contactos.
02 Conecta tu cuenta
Elige ConnectMachine en Zapier, inicia sesión con Google o un código por correo y aprueba los permisos. Se requiere una cuenta existente y con la incorporación completada. Si se revoca la conexión, vuelve a conectarla desde Zapier.
03 Campos de Crear contacto
Mapea tipo, nombre, apellidos, empresa, cargo, notas, red opcional, correo principal, teléfono y sitio web.
- Una persona requiere nombre.
- Una empresa requiere empresa.
- Se validan el correo y la URL.
- Sin Red se usa la red predeterminada.
04 Campos de Actualizar contacto
El ID es obligatorio. Selecciona un contacto reciente o usa un valor personalizado de un paso anterior.
- Los valores vacíos no borran datos en v1.
- Correo, teléfono y web actualizan o crean el dato principal.
- El contacto y la red deben pertenecer a la cuenta.
05 Evita bucles
Las acciones también generan disparadores normales con source=zapier y source_id.
ImportanteAñade un filtro “source no es exactamente zapier” cuando el Zap vuelva a escribir en ConnectMachine.
06 Contactos eliminados
El borrado individual, masivo, total y las fusiones pueden activar el disparador. Zapier recibe un elemento por contacto con deleted_at y sus datos anteriores. Los webhooks manuales siguen recibiendo solo IDs.
07 Privacidad y permisos
Zapier guarda las credenciales OAuth. ConnectMachine guarda identificadores de acceso y hashes de tokens de actualización; el navegador no guarda tokens.
- user:read identifica la conexión.
- contacts:read habilita disparadores y menús.
- contacts:write permite crear y actualizar.
- webhooks:write gestiona solo las suscripciones de Zapier.
08 Referencia para desarrolladores
OAuth usa código de autorización con PKCE S256. Las suscripciones usan /api/v1/zapier/subscriptions; las muestras /trigger-samples; y las acciones POST o PATCH /api/v1/zapier/contacts.
09 Solución de problemas
Un aviso Premium indica que el plan ya no es elegible. Un error de permisos requiere reconectar. Si Zapier devuelve 410, activa de nuevo el Zap para crear una suscripción nueva.