# Gemini + HeyMark

> En esta guía aprenderás a conectar HeyMark con Gemini para consultar tus publicaciones, calendario y métricas desde el chat, usando los datos reales de tu marca.


**Antes de empezar.**
Necesitas una cuenta de HeyMark y una cuenta personal de Google. Para analizar Instagram u otra red, esa cuenta social debe estar conectada a tu marca en HeyMark.

Comprobamos esta conexión desde Chile el 2 de noviembre de 2026, con una cuenta personal y Gemini en inglés. Busca **Crear una app personalizada / Create custom app** en Apps conectadas para comprobar si tu cuenta tiene acceso.

La [ayuda de Google](https://support.google.com/gemini/answer/17209137?hl=en-12) todavía indica disponibilidad en EE. UU. y un requisito de 18 años o más. Esa descripción regional no coincide con el acceso que comprobamos desde Chile; nuestra prueba no confirma disponibilidad para todas las cuentas. Google también exige **Guardar actividad** activado y excluye las cuentas de trabajo o de centros educativos.

## Cómo conectar Gemini con HeyMark

La conexión se hace desde Gemini en el navegador y se guarda en tu cuenta de Google. No necesitas una API key ni configurar un servidor: usarás la URL pública del MCP de HeyMark y autorizarás el acceso con tu propia cuenta.

Las grabaciones muestran Gemini en inglés. En el texto encontrarás también los nombres de los controles en español para que puedas ubicarlos.

### Prepara tu cuenta de HeyMark
Si ya usas HeyMark con tu marca, pasa al siguiente paso. Si estás empezando, entra a [HeyMark](https://app.heymark.ai), crea tu cuenta y conecta la red social que quieras consultar.

1. **Crea tu cuenta.** Entra a HeyMark y completa el registro para abrir tu espacio de trabajo.
2. **Conecta tu Instagram.** Abre tu marca y conecta la cuenta de Instagram que quieres consultar desde Gemini.

### Abre Apps conectadas en Gemini
Entra a [gemini.google.com](https://gemini.google.com/app?hl=en) con tu cuenta personal de Google. Abre **Configuración → Inteligencia personalizada → Apps conectadas**. En inglés verás **Settings → Personal Intelligence → Connected Apps**. En algunas cuentas, Apps conectadas aparece directamente dentro de Configuración.

También puedes abrir la [página de Apps conectadas](https://gemini.google.com/customize/connectors?hl=en). Deberías ver el botón **Custom / Personalizada** para crear una app.

### Añade la URL del MCP de HeyMark
Pulsa **Custom / Personalizada**. En **MCP Server URL**, pega esta dirección y pulsa **Next / Siguiente**:

**URL del MCP de HeyMark**

```text
https://mcp.heymark.ai
```

No necesitas abrir **Additional settings / Configuración adicional** ni escribir un Client ID o una contraseña en ese formulario.

### Revisa y autoriza la conexión
Gemini mostrará un aviso sobre el acceso a herramientas y el intercambio de datos. Léelo y, si estás de acuerdo, marca la casilla y pulsa **Connect / Conectar**. Google puede mostrar otro paso de vinculación con el botón **Agree and continue / Aceptar y continuar**.

Cuando se abra HeyMark, inicia sesión si hace falta. Comprueba que estás usando la cuenta correcta, revisa el acceso que solicita Google y pulsa **Permitir acceso**. Volverás a Gemini para terminar la conexión.

La URL del MCP es pública. Lo que da acceso a tus datos es esta autorización: Gemini recibe los permisos de tu cuenta de HeyMark, no acceso a marcas ajenas. La información que consultes también pasa a formar parte de la conversación con Gemini.

### Guarda la app como HeyMark
En **Save your custom app / Guarda tu app personalizada**, escribe **HeyMark** en el nombre. Debajo deberían aparecer las acciones disponibles, como **list_brands** y **get_brand_context**. El número puede cambiar a medida que HeyMark incorpora funciones.

Pulsa **Connect / Conectar**. Al terminar, HeyMark aparecerá dentro de **Custom apps / Apps personalizadas**. Si abres su ficha, podrás revisar las acciones y los permisos. Conserva las confirmaciones de las acciones que modifican o publican contenido.

### Comprueba que Gemini puede leer HeyMark
Abre un chat nuevo, escribe **@HeyMark** y selecciona HeyMark en el menú que aparece. Después pega el siguiente prompt. Si tienes varias marcas, elige cuál quieres consultar cuando Gemini te lo pregunte.

#### Primera prueba: sin cambiar nada

```text
Consulta HeyMark y dime cuántas marcas tengo disponibles. No crees, edites, programes ni publiques nada.

Si no puedes consultar el conector, dímelo. No respondas usando recuerdos de otra conversación ni inventes el resultado.
```

La señal de que funcionó es una respuesta que coincide con tus marcas en HeyMark. Puedes pedir después el nombre, la zona horaria y las redes conectadas de la marca que elijas para comprobar una segunda lectura.

## Qué puedes pedirle después

Gemini puede usar HeyMark para trabajar con el contexto de tu marca, preparar publicaciones, organizar al equipo, consultar resultados y atender conversaciones. También puede guardar cambios: crear borradores, programar contenido o configurar respuestas automáticas.

Elige **@HeyMark** antes de enviar un prompt y confirma con qué marca vas a trabajar. Abre el ejemplo que te sirva y ajústalo a tu caso. Algunas acciones dependen de tu plan, tus permisos y las redes que tengas conectadas.

Las miniaturas muestran el formato del resultado. Gemini lo preparará con los datos disponibles de tu marca.

### Conocer tu marca y encontrar ideas

#### Revisar el perfil de marca

Oferta, audiencia, temas y tono, con los datos que falta completar.

```text
Consulta el perfil de mi marca en HeyMark y sus cuentas conectadas. Si tengo varias marcas, pregúntame cuál quiero revisar.

Resume qué ofrecemos, a quién le hablamos, los temas que trabajamos y cómo escribimos. Distingue los datos que aportamos de lo que se dedujo del contenido publicado. Señala información que falta o que conviene revisar antes de usarla en una campaña.
```

#### Corregir el contexto

Una propuesta de cambio para revisar antes de guardarla.

```text
Quiero actualizar el contexto de mi marca en HeyMark. Pregúntame qué dato quiero corregir: identidad, audiencia, temas, tono, estructura, extensión, palabras, frases o notas.

Lee primero el valor actual y muéstrame cómo quedaría con la información que yo te dé. Pídeme aprobación antes de guardarlo. Conserva los demás campos.
```

#### Encontrar diez ideas

Diez enfoques con red, formato, apertura y una referencia de tu historial.

```text
Revisa el perfil y las publicaciones recientes de mi marca en HeyMark. Propón diez ideas para la próxima semana, repartidas entre los temas que ya trabajamos y otros que podríamos probar.

Para cada idea, incluye el enfoque, la red, el formato, una apertura y la publicación o dato que te sirvió de referencia. Explica qué hipótesis probaríamos. Presenta las ideas aquí antes de crearlas en HeyMark.
```

### Crear y adaptar publicaciones

#### Escribir guion y copy

Guion con qué se ve y qué se dice, más el texto de la publicación.

```text
Ayúdame a desarrollar una idea para mi marca en HeyMark. Pregúntame el tema y el objetivo, y consulta el contexto y ejemplos recientes de la marca.

Prepara un guion con apertura, desarrollo y cierre, indicando qué se ve y qué se dice. Añade el copy de la publicación en el tono de la marca. Muéstrame la propuesta; cuando la apruebe, guárdala como una nueva idea con su guion en HeyMark.
```

#### Crear tres borradores

Tres enfoques con copy, fecha de planificación y medios pendientes.

```text
Vamos a preparar tres publicaciones de una campaña en HeyMark. Pregúntame el objetivo, el producto o servicio, las redes y las fechas de planificación.

Propón primero los tres enfoques. Cuando los apruebe, crea los borradores con título, idea, copy y fecha de planificación. Indica qué archivos necesita cada pieza y devuelve sus enlaces. Déjalos sin programar ni publicar; una fecha de planificación no es una programación.
```

#### Adaptar una publicación

Una versión para otra red o marca, conservando el original.

```text
Quiero reutilizar una publicación de HeyMark. Pregúntame cuál es y a qué red o marca quiero llevarla. Lee su copy completo, planificación y medios, y el contexto de la marca de destino.

Muéstrame la adaptación del texto y los ajustes de formato necesarios. Después de mi aprobación, crea la copia como borrador y conserva la publicación original. Si un medio sigue importándose o no sirve para el destino, indícalo antes de programar.
```

#### Revisar video y portada

Mejoras de apertura, copy y portada según los archivos y análisis disponibles.

```text
Pregúntame qué publicación de HeyMark quiero revisar. Consulta sus archivos, portada, transcripción y análisis visual disponibles.

Resume qué muestra la pieza, qué se dice y cómo se relaciona con el copy. Propón mejoras concretas en la apertura, el texto o la portada. Si solo tienes una portada o falta el análisis del video, aclara qué parte pudiste revisar. No inventes escenas ni cambies archivos todavía.
```

Para añadir fotos, videos o una portada, Gemini necesita poder entregar esos archivos al conector. Si no puede, súbelos desde la publicación en HeyMark y continúa aquí con el copy, la revisión o la programación. Una imagen adjunta al chat no significa que ya esté guardada en la publicación.

### Ordenar el trabajo del equipo

#### Revisar la próxima semana

Calendario con huecos, piezas pendientes y un orden para terminarlas.

```text
Consulta el calendario de mi marca en HeyMark para la próxima semana. Confirma primero la marca, las fechas y la zona horaria.

Separa ideas, borradores, publicaciones programadas y publicadas. Señala los días sin contenido y las piezas que necesitan texto, archivos o una revisión del equipo. Incluye sus enlaces y propón un orden para terminarlas. Conserva sus fechas y estados actuales.
```

#### Asignar el trabajo de campaña

Etiquetas, responsables y comentarios internos propuestos para cada pieza.

```text
Ayúdame a organizar una campaña en HeyMark. Pregúntame qué publicaciones incluye y revisa las etiquetas, los estados de planificación y las personas disponibles en esa marca.

Propón una etiqueta de campaña, el responsable y el estado de cada borrador. Conserva los estados de las piezas que ya estén programadas o publicadas. Muéstrame también los comentarios internos que dejarías al equipo con los cambios pendientes. Cuando apruebe la propuesta, aplica esa organización y devuelve los enlaces. Los comentarios deben quedar dentro de HeyMark.
```

#### Vincular una publicación externa

Borrador y publicación real comparados antes de unirlos.

```text
Publiqué directamente en una red una pieza que había preparado en HeyMark. Ayúdame a encontrar el borrador y su publicación real en la cuenta conectada.

Compara texto, archivos, red y fecha. Muéstrame ambas piezas y pide mi aprobación antes de unirlas. Si todavía no aparece la publicación externa, comprueba si se puede solicitar su importación y distingue una búsqueda en curso de una publicación ya encontrada.
```

### Programar y publicar

#### Programar borradores listos

Revisión de cuenta, contenido, horario y aprobaciones antes de programar.

```text
Quiero programar contenido de mi marca en HeyMark. Pregúntame qué borradores, días y horas voy a usar, y confirma la zona horaria.

Comprueba la cuenta de destino, el copy, los archivos y las aprobaciones que necesita cada pieza. Muéstrame el resumen antes de ejecutar la programación y espera mi confirmación. Al terminar, devuelve los enlaces y el estado real de cada publicación. Si quedó pendiente de aprobación, indícalo.
```

#### Mover o cancelar una fecha

Cambio de fecha o retirada de la programación de una pieza concreta.

```text
Necesito cambiar una publicación programada en HeyMark. Pregúntame cuál es y si quiero moverla a otra fecha o quitar su programación.

Muéstrame la red, el contenido y la fecha actual. Si voy a moverla, confirma la nueva fecha, hora y zona horaria. Espera mi aprobación antes de cambiarla y comprueba después su estado. Conserva las demás publicaciones.
```

#### Publicar una pieza ahora

Versión y cuenta por confirmar; después, estado real y enlace cuando exista.

```text
Quiero publicar ahora un borrador de HeyMark. Pregúntame cuál y confirma la marca y la cuenta de destino.

Revisa que tenga el contenido y los archivos necesarios. Muéstrame la versión que va a salir y espera mi confirmación explícita antes de publicarla. Si HeyMark solo acepta la solicitud o la publicación sigue procesándose, dímelo así; comparte el enlace público cuando esté disponible.
```

**Comprueba qué acción estás autorizando.**
Crear una idea, guardar un borrador, cambiar su fecha de planificación y programar su publicación son acciones distintas. Antes de publicar, enviar una respuesta o activar una automatización, revisa el resumen de lo que va a ocurrir. Si hay una aprobación pendiente del equipo, complétala en HeyMark.

### Entender resultados, audiencia y referentes

#### Preparar el informe del mes

Resultados por red, cinco publicaciones y tres pruebas para el próximo mes.

```text
Prepara un informe de mi marca con los reportes de HeyMark del último mes completo. Confirma las fechas y separa los resultados por red.

Resume la evolución de seguidores y las métricas disponibles. Muestra cinco publicaciones para revisar, con sus enlaces, resultados y comparación con el período anterior cuando exista. Separa publicaciones del feed e historias. Termina con tres pruebas para el próximo mes y explica en qué datos se basan. Señala métricas faltantes, datos antiguos o resultados parciales.
```

#### Conocer a tu audiencia

Demografía disponible y tres enfoques de contenido para contrastar.

```text
Consulta la demografía disponible de la audiencia de mi marca en HeyMark: edades, género, países y ciudades.

Indica de qué red proviene y qué información falta. Cruza esa lectura con el perfil y las publicaciones recientes de la marca para proponer tres enfoques de contenido. Distingue lo que muestran los datos de tus hipótesis y evita asumir que todos los seguidores tienen el mismo interés.
```

#### Comparar con tus referentes

Métricas públicas de 30 días y tres publicaciones de las que aprender.

```text
Consulta los referentes que mi marca sigue en HeyMark. Pregúntame si quiero revisar Instagram o TikTok y usa un período de 30 días.

Compara nuestra cuenta con esas cuentas en las métricas públicas disponibles. Selecciona tres publicaciones que hayan destacado frente al rendimiento habitual de su propia cuenta y explica qué podemos aprender de ellas. Incluye enlaces y separa la observación de la hipótesis. No atribuyas a un referente alcance, impresiones o demografía que no sean públicos.
```

Con Referentes también puedes pedir que añada una cuenta pública de Instagram o TikTok, deje de seguirla o active su alerta. Confirma la red y el perfil exactos. Si añadirla requiere un cargo extra, HeyMark te pedirá completar ese paso desde la app.

### Atender el inbox y configurar respuestas

#### Priorizar el inbox

Conversaciones por tema, prioridad sugerida y borradores sin enviar.

```text
Revisa el inbox de mi marca en HeyMark y los casos pendientes que Mark haya pasado a una persona.

Agrupa las conversaciones entre consultas comerciales, soporte y otros temas. Resume qué pasó en cada caso y propone cuáles atender primero, con el contexto necesario para responder. Prepara borradores de respuesta con la información disponible de la marca. Mantén los mensajes sin enviar y sin cambiar su estado de lectura.
```

#### Preparar una respuesta

Hilo revisado y texto exacto para aprobar antes de enviarlo.

```text
Ayúdame a responder un comentario público o un mensaje directo desde HeyMark. Pregúntame cuál y lee el hilo completo disponible antes de redactar.

Propón una respuesta con el tono y los datos de la marca. Si falta información para contestar, pregúntamela. Muéstrame la cuenta, el destinatario y el texto exacto; espera mi aprobación antes de enviarlo. Comprueba después el resultado del envío.
```

#### Revisar la moderación

Propuestas de respuesta, revisión humana u ocultación, con su motivo.

```text
Revisa los casos de moderación pendientes y los comentarios recientes de mi marca en HeyMark. Si tengo comentarios de anuncios de Meta disponibles, inclúyelos por separado.

Señala cuáles necesitan una respuesta, cuáles conviene que revise una persona y en cuáles propones ocultar el comentario. Lee el contexto y explica cada propuesta. Pide mi aprobación para cualquier respuesta o cambio de visibilidad. No borres comentarios.
```

#### Crear una regla por palabra

Disparador, respuesta y DM opcional para revisar antes de activar.

```text
Quiero preparar una automatización de comentarios para una publicación de HeyMark. Pregúntame la publicación, la palabra clave, la respuesta pública y si debe enviar un DM con un enlace o botón.

Revisa primero las automatizaciones existentes y la disponibilidad de esa red. Muéstrame el disparador, los textos y qué ocurriría si el DM no puede enviarse. Espera mi aprobación antes de guardarla o activarla. No apliques la regla a comentarios antiguos sin preguntarme por separado.
```

#### Ajustar las respuestas de Mark

Instrucciones, aviso al equipo y criterio de traspaso propuestos para los DMs.

```text
Revisa la configuración de respuestas de Mark para los mensajes directos de mi marca en HeyMark. Resume si está activo, qué instrucciones usa y cuándo pasa una conversación al equipo.

Pregúntame qué quiero cambiar y a quién debería avisar si necesita ayuda. Muéstrame la configuración propuesta y espera mi aprobación antes de guardarla o activarla. Si solo necesitamos que una persona atienda un caso, propón pausar Mark en esa conversación.
```

**Gemini usa las capacidades que HeyMark le comparte.**
Estos ejemplos combinan consultas, propuestas de Gemini y acciones del conector. Si una herramienta no aparece en tu conexión o la cuenta no tiene acceso, Gemini debe indicarlo. Puedes revisar las acciones disponibles en la ficha de HeyMark dentro de Apps conectadas. Generar una imagen en Gemini, subirla a HeyMark y publicarla son pasos separados.

## Ahora ponlo a trabajar.

HeyMark aprende las reglas que acabas de escribir, y con eso planifica, redacta, programa y responde en esa voz. Tú apruebas.

[Empezar gratis](https://app.heymark.ai) · [Ver cómo funciona](https://heymark.ai/es/#product)

## Problemas comunes

### No aparece Crear una app personalizada
Comprueba que uses una cuenta personal, con Guardar actividad activado, y revisa los requisitos de edad e idioma en la ayuda de Google. Probamos el recorrido desde Chile, aunque la documentación aún menciona EE. UU.; ese acceso no garantiza que todas las cuentas de un país tengan la opción. Las cuentas de trabajo o centros educativos no admiten este recorrido por ahora. No necesitas cambiar el MCP de HeyMark para que aparezca el botón.

### HeyMark está conectado, pero Gemini responde sin consultarlo
Escribe **@HeyMark** y selecciona la app en el menú antes de enviar la pregunta. Empieza por el prompt de comprobación y contrasta la respuesta con HeyMark. Si no puede recuperar datos, pídele que explique el límite en lugar de completar la respuesta con suposiciones.

### La respuesta queda cargando o aparece un error
Prueba una pregunta corta en un chat nuevo. Si también falla una pregunta sin HeyMark, revisa primero el estado de Gemini. Puedes probar otro modo que tu cuenta tenga disponible; no necesitas contratar un plan nuevo para seguir estos pasos. La grabación de comprobación se hizo con Pro, pero no establece un requisito de plan.

### La autorización no vuelve a Gemini
Revisa si el navegador bloqueó una ventana de acceso y confirma que iniciaste sesión con la cuenta correcta de HeyMark. No pegues contraseñas ni tokens en el chat. Vuelve a Apps conectadas para comprobar si la conexión terminó antes de empezar otra vez.

### ¿Cómo desconecto HeyMark?
Vuelve a Apps conectadas, abre HeyMark y selecciona **Disconnect / Desconectar**. Google también permite quitar la app personalizada desde sus opciones. Desconectarla no cancela las publicaciones que ya estén programadas ni las automatizaciones que hayas activado en HeyMark.

## Enlaces útiles

- [Apps conectadas de Gemini](https://gemini.google.com/customize/connectors?hl=en): añade o administra HeyMark.
- [Ayuda oficial de Google](https://support.google.com/gemini/answer/17209137?hl=en-12): requisitos y pasos para apps personalizadas.
- [MCP de HeyMark](/es/mcp/): permisos, datos compartidos y acciones disponibles.
- [Claude + HeyMark](/es/guides/conectar-claude-heymark/): el mismo contexto de marca desde Claude.
- [ChatGPT + HeyMark](/es/guides/crear-carruseles-chatgpt-heymark/): conecta tus cuentas y prepara un carrusel.

Recorrido comprobado desde Chile el 2 de noviembre de 2026 con una cuenta personal de Google y Gemini en inglés. Esta guía conecta una app personalizada a tu cuenta; no requiere que HeyMark esté publicado en el directorio de Google. Los nombres de los controles y la disponibilidad pueden variar con el despliegue de Gemini.

## Recursos para desarrolladores y agentes

- [Documentación MCP de HeyMark](https://heymark.ai/es/mcp/)
- [llms.txt](https://heymark.ai/llms.txt)
- [Contenido completo del sitio para modelos de lenguaje](https://heymark.ai/llms-full.txt)
- Endpoint del protocolo MCP: `POST https://mcp.heymark.ai`
- Metadatos OAuth del recurso protegido: [/.well-known/oauth-protected-resource](https://mcp.heymark.ai/.well-known/oauth-protected-resource)
- MCP server card: [/server-card](https://mcp.heymark.ai/server-card)
