Aprende a usar Blooma.

Qué es Blooma

Blooma es una plataforma de gestión para agencias y equipos creativos. Reúne en un solo lugar la planeación de contenidos por cliente (PDC Calendar), las tareas (Manager), la capacidad del equipo (Planner), el registro de horas (Tracking), la aprobación de los clientes (Portal), la publicación en Instagram y los reportes (Insights).

Se usa desde app.blooma.io en el escritorio, desde el navegador del celular o con la app para iOS y Android.

Conceptos clave

Primeros pasos

1. Crea tu cuentaEntra a blooma.io/registro y crea tu cuenta con tu correo.
2. Crea o únete a una organizaciónCrea la organización de tu agencia y elige un plan, o únete a la de tu equipo con un código, una invitación, un enlace o el dominio de tu correo.
3. Invita a tu equipoDesde Ajustes → Organización, invita a las personas y asígnales un rol.
4. Agrega tus clientesEn Clientes, crea cada cuenta con sus servicios contratados y su @ de Instagram.
5. Arma el primer PDCEn PDC Calendar, crea el plan del mes. Blooma genera las 5 tarjetas de fase en el Manager y, al asignarlas, las tareas aparecen en el Planner.
6. Comparte el portalDesde la ficha del cliente, copia el enlace de su portal y envíaselo.
7. Conecta MetaSigue la guía de Meta para traer métricas y publicar en Instagram.

Equipo, roles y organizaciones

Los permisos se resuelven en dos capas: primero el plan de la organización (qué módulos están disponibles) y después el rol de la persona (a cuáles de esos módulos entra y qué acciones puede hacer).

• Permisos de administración: gestionar miembros, roles, la organización y la facturación.
• Roles personalizados con acceso por módulo: Planner, Registro de tiempo, Manager, Chat, Dashboard, Analytics, Insight y Clientes.
• Para cambiar de organización, abre la búsqueda y usa Cmd+Shift+O en Mac o Ctrl+Shift+O en Windows.

Integrar Meta: visión general

Blooma se conecta con Meta de dos formas independientes, ambas a nivel de organización. Puedes usar una, la otra o las dos.

Requisitos en Meta

• Una cuenta de Instagram profesional (de empresa) vinculada a una página de Facebook.
• Acceso de administrador al portafolio comercial (Meta Business) donde están la página, la cuenta de Instagram y, si aplica, la cuenta publicitaria.
• En Blooma, ser administrador de la organización para conectar las métricas.

Conectar métricas e Insights

Esta conexión usa el token de un usuario del sistema de Meta Business. Es estable y no depende de la sesión personal de nadie del equipo.

En Meta Business

1. Abre la configuración del negocioEntra a business.facebook.com/settings.
2. Crea un usuario del sistemaEn Usuarios → Usuarios del sistema, crea uno con rol de administrador.
3. Asígnale los activosAgrégale las páginas, las cuentas de Instagram y las cuentas publicitarias de los clientes que quieres medir.
4. Genera el tokenPulsa “Generar nuevo token” y marca estos permisos: instagram_basic, instagram_manage_insights, pages_read_engagement, read_insights y ads_read. Copia el token.

En Blooma

1. Abre IntegracionesVe a Ajustes → Organización → pestaña Integraciones. Solo la ven los administradores.
2. Pega el token y guardaBlooma lo valida y te muestra las cuentas de Instagram que detectó.
3. Completa cada clienteEn la ficha de cada cliente, agrega su @ de Instagram para ver su rendimiento orgánico y, si quieres resultados de pauta, el ID de su cuenta publicitaria de Meta.

Conectar la publicación en Instagram

1. Abre un PDCEn el panel “Publicación en Instagram”, pulsa Conectar Instagram.
2. Autoriza con FacebookInicia sesión con una cuenta que administre las páginas de tus clientes y acepta los permisos: instagram_basic, instagram_content_publish, pages_show_list, pages_read_engagement y business_management.
3. Blooma conecta las cuentasSe conectan todas las cuentas de Instagram de empresa vinculadas a las páginas que autorizaste. Al terminar vuelves a Blooma con la conexión confirmada.
4. Asigna cada cuenta a su clienteSi conectaste varias cuentas, elige cuál corresponde a cada cliente.

Blooma renueva el acceso de forma automática. Si Meta lo revoca (por ejemplo, porque cambió la contraseña de la cuenta o se quitaron permisos), vuelve a pulsar “Conectar Instagram”.

Versión de la Graph API

Blooma usa la versión v21.0 de la Graph API de Meta. Meta publica las fechas de caducidad de cada versión en su registro de versiones; la actualización la hace el equipo de Blooma y no requiere que reconectes nada.

Meta Ads (solo lectura)

Con el permiso ads_read del token de métricas y el ID de la cuenta publicitaria en la ficha del cliente, Blooma consulta los resultados de la pauta y los separa de los resultados orgánicos en el portal y en los reportes.

• Solo se hacen consultas de lectura a la Marketing API.
• Las campañas de pauta que planificas dentro del PDC (presupuesto y estado) son un registro interno de Blooma y no se envían a Meta.

Solución de problemas

Google Calendar

Cada persona conecta su propia cuenta de Google desde el Planner. Desde ese momento, sus bloques planificados aparecen como eventos en su calendario principal.

1. Abre el PlannerPulsa Conectar en la tarjeta de Google Calendar.
2. Autoriza con GoogleBlooma pide los permisos openid, email y calendar.events.owned (solo los eventos que crea Blooma).
3. ListoUsa “Sincronizar ahora” cuando quieras forzar una actualización, o desconecta desde el mismo lugar.

Portal de cliente

El portal es la vista de tu cliente. No necesita crear una cuenta en Blooma.

• Acceso: un enlace único por cliente, que puedes proteger con contraseña. Quien tenga el enlace (y la contraseña, si la pusiste) puede entrar, y una nueva sesión no saca a quienes ya están dentro. Para cortar el acceso, revoca el enlace desde la ficha del cliente.
• Qué ve: lo que está pasando ahora, el feed de actividad, entregables pendientes e historial, el equipo, resultados orgánicos y de pauta, reportes mensuales en PDF y el uso de los servicios (descargable en CSV).
• Qué puede hacer: aprobar o pedir cambios en los entregables y, en el plan del mes, aprobar, pedir cambios y comentar.
• Personalización: banner y colores de tu marca. En el plan Agency puedes ocultar la marca Blooma (white-label).
• En vivo: el portal se actualiza solo cuando hay actividad nueva, cambia un entregable o se publica un reporte.

Reglas para publicar

Para cuidar a tus clientes, Blooma solo publica una pieza cuando se cumple todo esto:

• El copy está aprobado y el cliente dio la aprobación final.
• El PDC está en revisión final del cliente o en una etapa posterior.
• El archivo de la pieza tiene una URL pública accesible para Meta.
• La pieza tiene caption (las historias no lo necesitan).
• Tu organización no ha llegado al límite de publicaciones mensuales de su plan.

Formatos: post, carrusel (hasta 10 elementos), reel e historia. Puedes publicar ahora, programar, cancelar una programación o marcar una pieza como publicada a mano. Blooma revisa cada minuto qué publicaciones programadas deben salir.

Cómo funcionan las APIs

Blooma tiene tres piezas: la aplicación web (y móvil), la API de Blooma y los servicios externos a los que esa API se conecta.

La API de Blooma

• REST sobre HTTPS con JSON. La app la consume con la sesión de la persona que inició sesión (token Bearer).
• Todo se filtra por organización. La organización activa sale de la sesión validada, nunca de lo que envía el navegador. Una organización no puede leer datos de otra.
• Permisos por plan y por rol en cada módulo, como se explica en Equipo y roles.
• El portal de cliente usa su propio acceso por enlace, separado de las sesiones del equipo.

¿Hay una API pública?

Llamadas a Meta

Estas son las operaciones que Blooma hace contra las APIs oficiales de Meta, con el token de tu organización:

Así es el flujo oficial de publicación de Meta que sigue Blooma: primero crea un contenedor con el archivo y el caption, y después lo publica.

# 1. Crear el contenedor de la publicación
POST https://graph.facebook.com/v21.0/{ig-user-id}/media
     image_url=https://…/pieza.jpg
     caption="Copy aprobado por el cliente"

# → { "id": "{creation-id}" }

# 2. Publicar el contenedor
POST https://graph.facebook.com/v21.0/{ig-user-id}/media_publish
     creation_id={creation-id}

Para pauta, Blooma solo hace consultas GET a la Marketing API. No existe en Blooma ninguna operación que cree, edite o pause anuncios.

Webhooks y tiempo real

Webhooks entrantes

• Meta: Blooma recibe eventos en un endpoint con verificación de firma HMAC. Hoy se registran para auditoría.
• Mercado Pago: confirma los pagos y renovaciones de las suscripciones.

Tiempo real

Blooma mantiene una conexión en vivo (WebSockets) con cada sesión abierta para que no tengas que recargar:

• Manager: tarjetas, listas y tableros se actualizan al instante para todo el equipo.
• PDC: aviso cuando cambia el estado de un calendario.
• Chat: mensajes, hilos, reacciones, mensajes fijados, “escribiendo” y presencia.
• Portal: se actualiza con nueva actividad, entregables, planes y reportes.

Seguridad y datos

• Los tokens de Meta se guardan cifrados y pertenecen a tu organización.
• Cada consulta a la API se limita a la organización activa de la sesión.
• La conexión con Facebook usa un parámetro de seguridad de un solo uso que vence a los 10 minutos.
• Meta Ads es de solo lectura y Google Calendar solo toca los eventos que crea Blooma.
• Puedes quitar cualquier conexión desde Ajustes o desde el módulo donde la activaste.

Lee la política de privacidad y la política de seguridad para conocer cómo tratamos y protegemos los datos.

Planes y límites

Los precios actualizados están en la sección de precios.

Glosario

Legal y privacidad

Blooma es un servicio de BRUTAL CORP S.A.S. (NIT 902.093.892-3, Calle 100 No. 17A-36, Bogotá). Estos son los documentos que regulan el uso del sitio, la plataforma, el portal de cliente y las apps para iOS y Android. Todos están en el Centro legal.

Tus datos y tus derechos

Tratamos los datos personales conforme a la Ley 1581 de 2012. Puedes conocer, actualizar, rectificar y suprimir tus datos, y revocar tu autorización, escribiendo a info@blooma.io. Los datos que tu agencia carga sobre sus clientes los trata Blooma por cuenta de la agencia, según el Acuerdo de Encargo del Tratamiento.

Eliminar cuenta y datos

Puedes eliminar tu cuenta desde Ajustes → Seguridad o escribiendo a info@blooma.io. Para borrar los datos obtenidos de Instagram, Facebook o Google, sigue la guía de eliminación de cuenta y datos.