API y exportaciones

La sección API e integraciones lleva los datos de Relator afuera: paneles en Looker Studio y Power BI, hojas de cálculo y sistemas propios. Todo es solo lectura: ninguna clave crea, edita ni publica nada en las cuentas de los clientes.

Antes de empezar

• Dónde está: Configuración › grupo Agencia › API e integraciones. En la cuenta propia, Configuración › API e integraciones, en el grupo Tu cuenta.
• Quién la usa: el equipo de la agencia (o el dueño de la cuenta propia). Dueño y Admin crean y revocan claves; Miembro solo ve. Las personas del cliente no tienen acceso a esta sección.
• Plan: la API viene incluida en Scale y Enterprise. En Starter y Pro, se libera con el complemento API y MCP. Sin el recurso, la sección muestra una pantalla de ejemplo y el camino para liberarla.

Qué hay en cada pestaña

• Claves de API

  Para qué sirve

  Crear, listar y revocar claves. También muestra la URL de la API, con el botón Copiar.

• Exportaciones programadas

  Para qué sirve

  Enviar un CSV por correo o a Google Drive cada día, semana o mes, sin clave.

• Looker Studio y Power BI

  Para qué sirve

  El paso a paso de cada herramienta y la URL del feed de Power BI, armada con selectores.

• Uso

  Para qué sirve

  Cuántas solicitudes recibió la API en el mes, frente al límite del plan.

Crear una clave

1. 1
   Paso 1

   Abre API e integraciones

   Haz clic en Configuración en la barra lateral y, en el grupo Agencia, en API e integraciones. Haz clic en Nueva clave.

   Pantalla ilustrativa

   Agencia Farol/API e integraciones

   Preguntar a RelatorAIPT

   API e integracionesSolo lectura · 200.000 solicitudes por mes

   Nueva clave1

   Claves de APIExportaciones programadasLooker Studio y Power BIUso

   Claves de acceso

   Nombre	Acceso	Clientes	Último uso
   Looker Studio · Korra	Lectura	1 cliente	hace 2 horas
   Power BI · todos	Lectura + metas	Todos (6)	Nunca usada

   2

   1. 1Nueva clave abre la creación en 3 pasos.
   2. 2Cada clave muestra qué lee, de qué clientes y cuándo se usó por última vez. Revocar está en la fila.

2. 2
   Paso 2

   Di para qué es

   Elige la finalidad: Looker Studio, Power BI, Hoja de cálculo o Sistema propio. Haz clic en Continuar.

3. 3
   Paso 3

   Elige qué lee la clave

   Después haz clic en Crear clave.

   • Qué puede leer: Métricas de medios (Meta Ads, Google Ads, GA4), CRM e ingresos (HubSpot, RD Station), Metas y SEO (Search Console).
   • Clientes: elige en la lista con búsqueda o marca Todos los clientes (incluye los nuevos).
   • Validez: 30 días, 1 año o Sin vencimiento.
   • Nombre: RelatorAI sugiere un nombre a partir de la finalidad y los clientes. Puedes editarlo.
4. 4
   Paso 4

   Copia la clave

   La ventana Clave creada muestra la clave completa una sola vez. Haz clic en Copiar clave y guárdala en un lugar seguro antes de Listo.

Usar la clave

• Looker Studio

  Cómo conectar

  Crea una clave con la finalidad Looker Studio, abre el conector de Relator en Looker Studio, autoriza y pega la clave cuando la pida. Si el botón Abrir el conector de Looker Studio está desactivado con el aviso Conector en publicación, usa Power BI, el CSV o las exportaciones programadas hasta que salga el conector.

• Power BI

  Cómo conectar

  En la pestaña Looker Studio y Power BI, elige el cliente, la fuente y el formato y copia la URL del feed (últimos 30 días, una fila por día). En Power BI, usa Obtener datos › OData (o Web), pega la URL y elige autenticación Básica: cualquier usuario y la clave como contraseña.

• Excel y hojas de cálculo

  Cómo conectar

  Usa la misma URL del feed en el formato CSV para Excel y hojas de cálculo, o programa el CSV en la pestaña Exportaciones programadas.

• Sistema propio

  Cómo conectar

  Llama a la URL de la API enviando la clave en el encabezado Authorization: Bearer. Para descargar una tabla, usa /metrics con format=csv.

Límites y uso

• Cada plan tiene un tope mensual de solicitudes, que aparece arriba de la sección y en la pestaña Uso: 50.000 por mes en Starter y Pro (con el complemento) y 200.000 en Scale. En Enterprise, el límite es de contrato.
• La pestaña Uso muestra el total del mes, la fecha en que se renueva y la proyección al ritmo actual.
• Al pasar del 90% del límite, aparece un aviso arriba de la sección y los dueños de la agencia reciben un correo.
• Por encima del límite, la API responde con error 429 hasta la renovación. Las exportaciones programadas no usan clave.
• Las claves sin uso durante 90 días expiran solas, además de la validez elegida.
• Una clave deja de funcionar si la persona que la creó sale de la agencia o deja de ser Dueño o Admin.

Exportaciones programadas

1. 1
   Paso 1

   Crea la exportación

   En la pestaña Exportaciones programadas, haz clic en Nueva exportación.

2. 2
   Paso 2

   Elige destino y contenido

   • Destino: Correo (CSV), eligiendo en Quién recibe a personas de la agencia, o Google Drive. Para Drive, conecta la cuenta antes con Conectar Google Drive; Relator solo ve la carpeta que él mismo crea.
   • Fuente: Meta Ads, Google Ads, Google Analytics 4, Search Console, HubSpot o RD Station.
   • Filas: por día o por campaña.
   • Clientes y Nombre, como en la clave.
3. 3
   Paso 3

   Define la frecuencia y programa

   Elige Todos los días, Cada semana (con el día de la semana) o Cada mes (con el día del mes) y la Hora, en la zona horaria que muestra la pantalla. Haz clic en Programar exportación.

• Por correo llega un enlace de descarga. El enlace vale 7 días y exige iniciar sesión en Relator con la misma agencia.
• Un enlace vencido, de otra cuenta o de una exportación eliminada abre la pantalla Este enlace de descarga ya no es válido. La próxima entrega envía un enlace nuevo.
• Cuando un envío falla, la fila muestra Falló con el motivo y el botón Intentar de nuevo. Si Drive perdió el acceso, usa Reconectar Google Drive.
• Eliminar detiene los próximos envíos. Los archivos ya enviados se quedan donde están.

Revocar una clave

En la pestaña Claves de API, haz clic en Revocar en la fila de la clave y confirma. El acceso se corta en la próxima solicitud y los paneles que usan la clave dejan de actualizarse. Revoca siempre que alguien que conoce la clave salga de la agencia o cuando la clave aparezca donde no debía.

¿Y los webhooks?

Relator todavía no envía webhooks. En Configuración › Notificaciones, el Webhook firmado aparece en Próximos canales, marcado como Próximamente. Para enterarte de problemas, usa las alertas y las notificaciones por correo.

Disponibilidad por plan

Problemas comunes

• No veo Nueva clave. Tu rol es Miembro. Pide a un Dueño o Admin de la agencia.
• La sección muestra “Disponible desde” un plan. El plan no incluye la API. Contrata el complemento API y MCP o pasa a Scale. Mira Complementos.
• El panel dejó de actualizarse. La clave fue revocada, expiró (validez o 90 días sin uso) o quien la creó salió de la agencia. Crea una clave nueva y cámbiala en el panel.
• Error 429. Se acabó el límite del mes. La pestaña Uso muestra cuándo se renueva.
• La URL del feed no aparece. Ningún cliente tiene una fuente conectada. Conecta una fuente en el cliente primero.