Integración Google Contacts n8nAutomatiza Google Contacts con n8n.
La agenda de contactos envejece mal cuando se mantiene a mano. La integración Google Contacts n8n trabaja sobre un único recurso, Contact, con 5 operaciones: crear, leer, listar, actualizar y borrar. No hay nodo trigger, así que el flujo arranca fuera. Encaja cuando varias personas comparten la misma agenda.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Qué resuelve de verdad la integración Google Contacts n8n?
La integración Google Contacts n8n es un nodo incluido en n8n que habla con la API de Google People en nombre de una cuenta de Google concreta. Gestiona un solo recurso, Contact, con 5 operaciones: crear una ficha, leer una por su identificador, listar varias con una búsqueda, actualizar una existente y borrarla. La agenda deja de ser ese archivo que alguien corrige a ratos, entre dos tareas más urgentes.
Primer caso, el alta. Un formulario escribe en una hoja de cálculo, el flujo lee las filas nuevas y crea la ficha con nombre, correo y teléfono. Con Google Sheets como puerta de entrada, Google Contacts se queda con la copia limpia, la que se sincroniza en el móvil de todo el equipo.
Segundo caso, la campaña. Antes de enviar nada con Gmail, un flujo recupera la agenda entera con Return All, separa las fichas sin correo y las completa con contact.update a partir de otra fuente. El mismo encadenamiento arregla teléfonos mal escritos o reasigna grupos en una sola pasada.
Tercer caso, el control diario. Un Schedule Trigger, el nodo de n8n que lanza un flujo cada cierto intervalo, ejecuta contact.getAll ordenado por última modificación y publica en un canal de Slack lo que ha cambiado desde ayer. Nadie revisa la agenda a mano y aun así nadie se pierde un cambio.
Donde el nodo se queda corto entra HTTP Request. Llama a cualquier endpoint de la API de Google People reutilizando la misma credencial mediante la autenticación predefinida, así que todo lo que las 5 operaciones no exponen sigue siendo posible. No es un apaño, es la salida prevista.
Conviene tener presentes dos límites antes de montar nada. No existe nodo trigger de Google Contacts: nada vigila la agenda, el arranque viene siempre de fuera. Y una actualización escribe lo que le pasas, de ahí el campo Etag leído antes, que protege una ficha que otra persona haya tocado mientras tanto.
Si todavía estás eligiendo plataforma, la Reseña n8n entra en el alojamiento y el modelo de coste, y el Curso n8n monta este tipo de flujo desde cero.
¿Cómo se conecta Google Contacts con n8n?
- 01
Crear el proyecto en Google Cloud y activar la API
En la Google Cloud Console, crea un proyecto o reutiliza uno, y activa desde la biblioteca la API que el nodo necesita. Abre luego APIs and Services y OAuth consent screen, y rellena App name y User support email. Elige Internal si todos están en tu Google Workspace, o External para cualquier cuenta de Google. En la sección Branding, añade
n8n.cloudcomo dominio autorizado en n8n Cloud, o el dominio de tu instancia si la alojas tú. - 02
Generar las credenciales de cliente OAuth
En Credentials, pulsa Create credentials y elige OAuth client ID. El tipo de aplicación es Web application, y conviene renombrarlo a algo reconocible. Copia la OAuth Redirect URL que muestra la pantalla de la credencial en n8n y pégala en Authorized redirect URIs. Si n8n corre en tu máquina no hacen falta dominio público ni certificado: Google admite una dirección localhost como
http://localhost:5678/rest/oauth2-credential/callback. - 03
Cerrar la credencial dentro de n8n
Vuelve a n8n, entra en Credentials y crea una credencial Google OAuth2 para este servicio. Pega el Client ID y el Client Secret de la consola y lanza el inicio de sesión. En n8n Cloud, el Managed OAuth2 se salta toda la configuración en Google para los nodos de Google que lo admiten: basta con pulsar Sign in with Google, y el desplegable cambia a Custom OAuth2 si lo prefieres. La credencial se crea una vez y aparece en cualquier flujo.
Las 5 operaciones del nodo Google Contacts
El nodo Google Contacts expone 5 operaciones en 1 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
Contact
5 operacionesCreate a contact
contact.createLo que ves en n8n
Notas y casos de uso
Añade una ficha nueva a la cuenta de Google asociada a la credencial y devuelve el registro creado, con el identificador que esperan las demás operaciones.
Parámetros clave
- Given Name y Family Name: los dos campos de nombre que el nodo muestra directamente, normalmente mapeados desde el item de entrada con
{{ $json.givenName }}. - Additional Fields: una colección de 14 campos opcionales donde Emails, Phone y Addresses se añaden de una en una, y donde Group Names or IDs coloca la ficha en un grupo que ya existe.
Delete a contact
contact.deleteLo que ves en n8n
Notas y casos de uso
Elimina a una persona de la agenda. En el lado de Google no hay vuelta atrás, así que el flujo debería decidir antes de llegar a este nodo.
Parámetros clave
- Contact ID: el identificador obligatorio de la ficha, que sale de una lectura previa y no se escribe a mano, casi siempre como
{{ $json.contactId }}desde el item de un listado.
Get a contact
contact.getLo que ves en n8n
Notas y casos de uso
Lee una sola persona y devuelve solo las partes de la ficha que pidas.
Parámetros clave
- Contact ID: obligatorio, señala la ficha que se va a leer.
- Fields: la máscara de campos que recorta la respuesta, desde
namesoemailAddressespor separado hasta*para traerlo todo. Se pueden marcar varios valores a la vez. - RAW Data: activado, el item conserva la forma exacta que devuelve la API en lugar de la versión simplificada.
Get many contacts
contact.getAllLo que ves en n8n
Notas y casos de uso
Lista los contactos de la cuenta, con una búsqueda por principio de palabra cuando solo quieres una parte de la agenda.
Parámetros clave
- Return All: marcado, n8n encadena las páginas de la API hasta terminar la lista; sin marcar, Limit fija cuántas fichas vuelven.
- Use Query y Query: la consulta compara el principio de los campos, así
foo nencuentra a la persona foo name yoo nno encuentra nada. - Sort Order: ordena por nombre, por apellido o por fecha de modificación.
Update a contact
contact.updateLo que ves en n8n
Notas y casos de uso
Modifica una ficha existente y escribe únicamente los campos que rellenes.
Parámetros clave
- Contact ID: obligatorio, apunta al registro que se corrige.
- Update Fields: una colección de 17 campos con los nombres, Emails, Phone, Notes, Birthday y el resto.
- Etag: el valor leído antes en esa misma ficha, que confirma que nadie la ha cambiado desde entonces. Saltárselo es lo que hace que dos flujos se pisen sin avisar.
¿Necesitas ayuda para automatizar Google Contacts con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
Google Contacts y n8n: lo que sueles preguntarte después
01¿La integración Google Contacts n8n es gratuita?
02¿Qué credencial hace falta para Google Contacts en n8n?
03¿Qué límites tiene el nodo Google Contacts en n8n?
04¿Se puede reaccionar en tiempo real a un contacto nuevo de Google Contacts?
05¿n8n o Make para Google Contacts?
Recibe nuestros tips de integración cada semana.
Sin spam. Cancela cuando quieras.
