Qué es Blooma
Blooma es una plataforma todo en uno para trabajar con metodologías ágiles. Reúne tableros y tareas (Manager), sprints (Scrum), la capacidad del equipo (Planner), el registro de tiempo (Tracking), chat, documentos, objetivos (OKR), CRM, formularios y automatizaciones, conectados entre sí. Cada organización enciende solo los módulos que usa.
Si trabajas para clientes, el paquete agencias suma fichas de cliente, parrilla de contenidos (PDC Calendar), portal de aprobación, publicación en Instagram y 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
| Concepto | Qué es |
|---|---|
| Organización | El espacio de trabajo de tu empresa o equipo. Sus datos están aislados de otras organizaciones. Una persona puede pertenecer a varias. |
| Miembro y rol | Cada persona del equipo tiene un rol (dueño, administrador, miembro o uno personalizado) que define a qué módulos entra y qué puede hacer. |
| Módulo | Cada parte de Blooma (Sprints, CRM, Documentos…). Quien administra la organización los enciende o apaga; los activos aparecen para todos en el menú, dentro de «Módulos». |
| Cliente | (Paquete agencias) Cada cuenta que atiendes. Tiene ficha, servicios contratados, portal, @ de Instagram y, si aplica, su cuenta publicitaria de Meta. |
| PDC | Plan de contenidos de un cliente para un mes. Contiene las piezas (reel, post, carrusel, historia, video, short, tweet o artículo). |
| Tablero y tarjeta | El Manager organiza el trabajo en tableros con columnas y tarjetas. |
| Bloque | Una franja de tiempo planificada en el Planner para una persona y una tarea, con la etapa del tablero en la que se trabaja. |
| Sprint | Un periodo corto (dos semanas por defecto) con un objetivo y las tarjetas que el equipo se compromete a terminar. |
| Lead | Una oportunidad en el CRM, con su etapa, valor y bitácora. |
Primeros pasos
- Crea tu cuentaEntra a blooma.io/registro y crea tu cuenta con tu correo.
- Crea o únete a una organizaciónCrea la de tu empresa o equipo y cuéntanos a qué se dedica: encendemos los módulos que te sirven. O únete a una existente con un código, una invitación, un enlace o el dominio de tu correo.
- Invita a tu equipoDesde Configuración → Organización, invita a las personas y asígnales un rol.
- Arma tu primer tableroEn el Manager, crea un tablero desde una plantilla por metodología o importa el que ya tienes.
- Planifica la semanaAsigna tarjetas y planifícalas en el Planner; si trabajas por sprints, arma el primero en Sprints.
- Enciende lo que necesitesCRM, Documentos, Objetivos, Formularios, Automatizaciones, Daily y retros o el paquete agencias, desde Módulos.
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 (todos los que la organización tenga encendidos).
- Además del plan y el rol, la organización decide qué módulos usa: ver Encender y apagar módulos.
- Para cambiar de organización, abre la búsqueda y usa
Cmd+Shift+Oen Mac oCtrl+Shift+Oen Windows.
Encender y apagar módulos
Cada organización trabaja solo con lo que necesita. Quien administra la organización entra a Configuración → Organización → Módulos y enciende o apaga cada uno con un interruptor. Los módulos activos aparecen para todo el equipo en el menú lateral, dentro de Módulos; Inicio, Manager, Planner y Chat quedan siempre a la vista.
- Apagar no borra nada. El módulo y su información se ocultan; al encenderlo, todo vuelve como estaba.
- Dependencias. Algunos módulos necesitan otros (por ejemplo, PDC Calendar necesita Clientes). Blooma te avisa antes de apagar uno del que dependen otros.
- Plan. Si un módulo no está incluido en tu plan, aparece como «No incluido en tu plan» con el enlace a los planes.
- Paquete agencias. Clientes, PDC Calendar, Insights, portal y entregas se encienden de una vez.
Plantillas e importar
En el Manager, abre el selector de tableros y elige Desde una plantilla o importar un tablero.
- Plantillas: Kanban, Scrum, lanzamiento de producto, seguimiento comercial, soporte, contenidos y onboarding. Cada una crea las columnas y una tarjeta guía con los primeros pasos.
- Importar un export JSON de un tablero: trae las columnas abiertas, las tarjetas sin archivar, etiquetas, vencimientos y checklists.
- Importar un CSV o Excel con una fila por tarea. Blooma reconoce columnas como Tarea, Estado, Descripción, Vence y Etiquetas; cada estado distinto se vuelve una columna.
- Puedes crear el tablero como público (toda la organización) o privado (solo sus miembros).
Dependencias y límite por columna
- Dependencias: en la ficha de una tarjeta, sección Dependencias, busca la tarjeta que la bloquea. Mientras el bloqueo no esté terminado, la tarjeta muestra «Bloqueada». No se permiten ciclos.
- Límite por columna (WIP): desde el menú «⋯» de la columna fija un máximo. El encabezado muestra «3/5» y avisa cuando se supera; no impide mover tarjetas.
- El Planner te avisa si planificas una tarea que sigue bloqueada.
Planner
- La grilla de día y semana va por medias horas: dos tareas de 30 minutos en la misma hora se ven completas.
- Al planificar, elige la etapa del tablero en la que se trabajará ese bloque (por defecto, la columna actual de la tarjeta). También se cambia en el detalle del bloque.
- Planificar otra vez pone la misma tarea en otros días u horas sin mover los bloques que ya tiene.
Sprints
- Estima el backlogEn Sprints, elige el tablero y ve a Backlog y planificación. Pon puntos a cada tarjeta (0, 1, 2, 3, 5, 8, 13, 21).
- Arma el sprintCrea el sprint con un objetivo (dura dos semanas por defecto) y pasa tarjetas desde el backlog. Blooma te avisa si comprometes más de lo que el equipo suele terminar.
- InícialoSolo puede haber un sprint en curso por tablero. Mover una tarjeta en el tablero del sprint la mueve en el Manager.
- CiérraloLo terminado cuenta para la velocidad; lo pendiente pasa al backlog o al siguiente sprint.
Reportes: burndown diario con cambios de alcance, velocidad de los últimos sprints y el tiempo estimado frente al planificado en el Planner y al registrado en Tracking, contra la capacidad del equipo.
CRM
- Crea un CRM para tu organización o uno por cliente. Cada uno tiene etapas (Nuevo, Contactado, Calificado, Propuesta, Ganado, Perdido) que puedes ajustar.
- Cada lead tiene correo, teléfono, empresa, fuente, valor, responsable, notas, campos personalizados y una bitácora de notas, llamadas, correos y reuniones.
- Próxima acción: pon fecha y nota; Blooma le avisa al responsable cuando vence y la marca como «Vencida».
- Importar: sube tu Excel o CSV; Blooma reconoce las columnas y salta los repetidos por correo o teléfono. También exporta a CSV.
- Reportes: embudo por etapa con conversión, tasa de ganados, días promedio para cerrar y leads por fuente.
- Convertir un lead ganado en cliente (paquete agencias) y en proyecto: un tablero con su tarjeta de inicio y toda la historia enlazada.
- Tareas del lead: desde la ficha creas una tarea que queda en el Planner del responsable; si la agendas, llega a su Google Calendar.
- Rol «CRM solo lectura»: ve y exporta, pero no crea ni cambia nada. Se activa en Ajustes → Organización → Roles.
Espacios, contactos y empresas
Los CRM se agrupan en espacios: el de tu organización y, en el plan Business, uno por cada cliente. Cada espacio tiene sus contactos y empresas, su WhatsApp y su Información para la IA.
- Cada lead nuevo (creado a mano, importado o que llega por un formulario o por WhatsApp) se enlaza solo con su contacto: mismo correo o, si no hay, mismo teléfono. Y con su empresa por nombre.
- En CRM → Contactos y empresas buscas a una persona o empresa y ves todos sus leads.
- Fuera del plan Business, todos los pipelines que quieras van en el espacio de tu organización.
Bandeja de WhatsApp e Instagram
La Bandeja (CRM → Bandeja) reúne las conversaciones de WhatsApp y los mensajes directos de Instagram de todos tus espacios para que el equipo responda desde Blooma. Se enciende con el módulo «Bandeja del CRM». El número se conecta en Conectar WhatsApp y la cuenta en Instagram en la Bandeja.
- Lista: Abiertas, Mías, Sin asignar y Resueltas, con filtro por espacio y búsqueda por nombre o número.
- Conversación: responde, deja notas internas que la persona no ve, usa respuestas rápidas escribiendo
/y asigna quién atiende. - Ficha: el contacto, sus leads, crear un lead en un clic y si autoriza mensajes de marketing.
- Contacto y lead automáticos: cada número nuevo crea su contacto en el espacio y, si lo eliges en el canal, también un lead en el pipeline que digas.
- Si la persona llegó por un anuncio de Click a WhatsApp o a Instagram Direct, ves de qué anuncio vino.
- El equipo de tu cliente: en Compartir del CRM, marca «También atiende la Bandeja» al invitar (o el interruptor Bandeja de cada persona). Esa persona ve y responde solo las conversaciones del espacio de ese cliente, con su nombre en cada mensaje; no asigna ni crea leads desde ahí.
Reglas de WhatsApp y de Colombia
| Regla | Qué hace Blooma |
|---|---|
| Ventana de 24 horas | Puedes escribir texto libre durante 24 horas desde el último mensaje de la persona. Después, solo con una plantilla aprobada por Meta: Blooma las lista y llenas sus variables. |
| Baja de marketing | Si la persona escribe «baja», «stop», «no más promociones» o «cancelar suscripción», queda registrado y no se le envían plantillas de marketing. |
| Ley 2300 de 2023 | Las plantillas de marketing solo salen de lunes a viernes de 7:00 a 19:00 y sábados de 8:00 a 15:00 (hora de Colombia), nunca domingos ni festivos. |
| Estado de entrega | Cada mensaje muestra enviado, entregado o leído; si WhatsApp no lo entrega, ves el motivo. |
| Puedes responder durante 24 horas desde el último mensaje de la persona, con textos de hasta 1.000 caracteres. Instagram no tiene plantillas: después de 24 horas hay que esperar a que la persona vuelva a escribir. Si borra un mensaje, también se borra en Blooma. |
Plantillas por industria
En CRM → Plantillas por industria eliges tu tipo de negocio y Blooma crea todo de una vez. Solo cambias unos datos: el espacio, el nombre del negocio, el nombre del pipeline, la moneda y a quién avisar.
| Plantilla | Etapas |
|---|---|
| Restaurante | Nuevo pedido → Confirmado → En preparación → En camino → Entregado / Cancelado |
| Tienda en línea (e-commerce) | Consulta → Cotizado → Esperando pago → Pago confirmado → Enviado → Entregado / No compró |
| Servicios B2B o agencia | Prospecto → Reunión agendada → Propuesta enviada → Negociación → Ganado / Perdido |
| Salud y estética | Solicitud → Cita agendada → Confirmada → Atendida / No asistió o canceló |
| Inmobiliaria | Interesado → Calificado → Visita agendada → Oferta o documentos → Cerrado / Descartado |
| Educación y cursos | Interesado → Información enviada → Inscrito → Matriculado / No continúa |
Cada plantilla trae además:
- Campos personalizados del negocio: tipo de pedido, fecha, dirección, canal, método de pago, presupuesto, zona…
- Automatizaciones de aviso: lead nuevo, paso a una etapa clave, ganado o perdido. Necesitan el módulo Automatizaciones encendido.
- Respuestas rápidas de WhatsApp como
/hola,/horario,/pagoso/menu, con la información de tu negocio ya puesta. - Las secciones de Información para la IA de tu industria.
Puedes aplicar la misma plantilla otra vez sin miedo: reutiliza el pipeline y solo agrega lo que falta. Una respuesta rápida que depende de una sección vacía (por ejemplo, el menú) se crea cuando completas esa sección y vuelves a aplicar.
Información para la IA
Cada espacio tiene una Información para la IA (CRM → Contactos y empresas): horario, dirección y cobertura, catálogo o menú, envíos, medios de pago, políticas, preguntas frecuentes y el tono con que se debe responder. Cada sección trae una pista y un ejemplo.
- Hoy la usa tu equipo y alimenta las respuestas rápidas de WhatsApp.
- Es lo que leerá la IA que tu organización conecte para responder por WhatsApp: cada organización pondrá su propia llave de IA. Mientras más clara esté, mejor responde.
- ¿No quieres escribirla desde cero? Copia el prompt para redactarla, pégalo en tu IA con tu web o tu menú y pega aquí el resultado.
Compartir un CRM
Desde el CRM, pulsa Compartir e invita a una persona por correo, con permiso para editar o solo ver. Le llega un correo con un enlace de un solo uso (vence en 7 días) para crear su contraseña.
- Entra por un enlace distinto al del portal, con su correo y contraseña, y ve el mismo CRM que tu equipo.
- Quedan registrados su último ingreso y los ingresos recientes con su dispositivo.
- Tras 5 intentos fallidos la cuenta se bloquea 15 minutos. Quitar acceso o apagar el acceso externo cierra su sesión al instante.
Formularios
- Crea el formularioEn Formularios, agrega campos (texto, correo, teléfono, número, selección, casilla) y elige a qué dato va cada uno.
- Elige el destinoUn pipeline y etapa del CRM (crea un lead) o una columna del Manager (crea una tarjeta), y a quién avisar en cada envío.
- CompárteloCopia el enlace o el código para incrustarlo en tu web. Puedes pausarlo cuando quieras.
Los envíos tienen protección contra spam (campo trampa, tiempo mínimo y límite de 10 por hora por dirección) y se pueden exportar a CSV.
Automatizaciones
Cada regla dice «Cuando… entonces…». Créala desde cero o con una receta.
| Cuando | Entonces |
|---|---|
| Una tarjeta entra a una columna, se crea o se completa | Asignar a alguien, poner fecha de vencimiento, moverla a otra columna o avisar a personas |
| Un lead se crea o cambia de etapa (incluida ganado o perdido) | Crear una tarjeta con los datos del lead, mover el lead o avisar a su responsable |
Cada regla tiene interruptor, contador y bitácora de ejecuciones. Las acciones de una automatización nunca disparan otras reglas, así que no se forman bucles.
Documentos
- Páginas en árbol con editor Markdown (negrita, títulos, listas, checklist, enlaces, código) y vista de lectura. Se guarda solo.
- Versiones: revisa y restaura cualquiera de las últimas 50. Si alguien guardó mientras editabas, Blooma te pregunta antes de pisar su cambio.
- Plantillas: acta de reunión, especificación de producto, proceso paso a paso y brief de cliente.
- Pendientes a tarjetas: los ítems
- [ ]sin marcar se convierten en tarjetas de la columna que elijas, enlazadas a la página. - Vincula la página a tarjetas, leads y clientes para encontrarla desde ahí.
Objetivos
- Crea objetivos por periodo (trimestre o año) con responsable.
- Cada resultado clave se mide por número, porcentaje, valor o tarjetas vinculadas: este último avanza solo cuando el equipo las termina.
- Registra el avance con una nota y revisa el historial en el gráfico.
- La confianza (En camino, En riesgo o Atrasado) compara el avance con el tiempo que ha pasado del periodo.
Daily y retros
- Daily: cada persona responde una vez al día qué hizo, qué hará y qué la bloquea. La respuesta viene prellenada con las tarjetas que terminó, sus bloques del Planner de hoy y el tiempo registrado.
- Vista del equipo: respuestas por fecha, bloqueos primero y quién falta por responder.
- Retros: elige el formato, agrega ítems, vota (3 votos por persona) y convierte cada acción en una tarjeta. En modo anónimo nadie ve quién escribió qué.
Menciones y avisos
- Escribe @ en el chat o en los comentarios de una tarjeta y elige a la persona. Le llega un aviso con el enlace, solo si puede ver ese canal o tablero.
- El responsable de un lead recibe un aviso cuando el lead cambia de etapa y cuando vence su próxima acción.
Dashboard personalizable
En Inicio, pulsa Personalizar para elegir qué widgets ves, en qué orden y si van normales o anchos. Además de los de siempre, hay widgets de CRM, sprints en curso, Mi día y tareas vencidas. Solo aparecen los de módulos encendidos; Restablecer vuelve al tablero de inicio original.
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.
| 1 · Métricas e Insights | 2 · Publicación en Instagram | |
|---|---|---|
| Para qué | Métricas de Instagram, análisis de cuentas, reportes mensuales y resultados de pauta. | Publicar y programar posts, carruseles, reels e historias. |
| Cómo se conecta | Token de un usuario del sistema de Meta Business, pegado en Blooma. | La app de Meta de tu agencia y, con ella, el botón “Conectar Instagram” (Facebook Login). |
| Dónde | Ajustes → Organización → Integraciones (solo administradores). | Las llaves de la app en Ajustes → Organización → Integraciones; la conexión de cada cuenta dentro de un PDC. |
| Permisos | instagram_basic, instagram_manage_insights, pages_read_engagement, read_insights, ads_read | instagram_basic, instagram_content_publish, pages_show_list, pages_read_engagement, business_management |
Meta Ads es de solo lectura. Blooma únicamente consulta resultados de pauta. Nunca crea, edita ni pausa campañas, ni cambia presupuestos.
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.
Si manejas clientes que tienen su propio portafolio comercial, pide que te compartan sus activos (página, Instagram y cuenta publicitaria) con el portafolio de tu agencia antes de conectar.
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
- Abre la configuración del negocioEntra a business.facebook.com/settings.
- Crea un usuario del sistemaEn Usuarios → Usuarios del sistema, crea uno con rol de administrador.
- Asígnale los activosAgrégale las páginas, las cuentas de Instagram y las cuentas publicitarias de los clientes que quieres medir.
- Genera el tokenPulsa “Generar nuevo token” y marca estos permisos:
instagram_basic,instagram_manage_insights,pages_read_engagement,read_insightsyads_read. Copia el token.
En Blooma
- Abre IntegracionesVe a Ajustes → Organización → pestaña Integraciones. Solo la ven los administradores.
- Pega el token y guardaBlooma lo valida y te muestra las cuentas de Instagram que detectó.
- 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.
El token se guarda cifrado y solo lo usa tu organización. Puedes reemplazarlo o quitarlo cuando quieras desde la misma pestaña.
La app de Meta de tu agencia
Para publicar en Instagram y responder comentarios, cada organización usa su propia app de Meta. Las llaves se cargan en Blooma una sola vez, se guardan cifradas y solo las usa tu organización. Las ven el administrador de la organización y las personas con un rol que tenga el permiso “Gestionar integraciones”.
En Meta for Developers
- Crea la appEntra a developers.facebook.com/apps con una persona administradora del portafolio comercial de tu agencia y crea una app de tipo Empresa, vinculada a ese portafolio.
- Agrega los productosAgrega Inicio de sesión con Facebook y la API de Instagram con inicio de sesión de Facebook.
- Copia las llavesEn Configuración de la app → Básica están el identificador de la app y la clave secreta. Las vas a pegar en Blooma.
En Blooma
- Abre IntegracionesVe a Ajustes → Organización → pestaña Integraciones → “App de Meta”.
- Pega el ID y la clave secretaPulsa Guardar app de Meta. La clave queda cifrada y en pantalla solo ves sus últimos 4 caracteres.
- Registra la URL de redirecciónCopia la “URL de redirección” que te muestra Blooma y pégala en Meta, en Inicio de sesión con Facebook → Configuración → URI de redireccionamiento de OAuth válidos.
- Configura el webhookEn Meta, producto Webhooks → objeto Instagram: pega la “URL del webhook” y el “Token de verificación” que te muestra Blooma, verifica y suscribe el campo
comments. Cada organización tiene su propia URL. - Publica la appPasa la app a modo Activo en Meta. Mientras esté en desarrollo, solo pueden conectarse las personas con un rol en la app.
Publicar (posts, carruseles, reels, historias y reels de prueba) solo necesita los permisos básicos. Responder comentarios, escribir por privado y recibir el aviso de comentarios necesitan la revisión de Meta: mira Automatizaciones de comentarios.
Conectar la publicación en Instagram
Antes, un administrador tiene que cargar la app de Meta de tu agencia. Si falta, Blooma te lo avisa al pulsar “Conectar Instagram”.
- Abre un PDCEn el panel “Publicación en Instagram” (o en el paso “Redes del cliente” al crear el PDC), pulsa Conectar Instagram.
- 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_engagementybusiness_management. - 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.
- 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”.
Opciones de cada pieza
- Reel de prueba: Instagram lo muestra primero a quienes no te siguen. Eliges si lo pasas a público a mano desde la app de Instagram o si Instagram lo pasa solo cuando funciona bien.
- Desactivar comentarios: se aplica apenas se publica. Necesita el permiso
instagram_manage_commentsaprobado. - Colaboradores: hasta 3 cuentas en posts, carruseles y reels.
- Ocultar los Me gusta no está disponible para apps: se activa desde la app de Instagram, en el post.
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.
Automatizaciones de comentarios
En PDC → Automatizaciones puedes crear reglas como: “quien comente info recibe una respuesta pública y un mensaje privado con el enlace al catálogo”. Funcionan en todas las publicaciones de la cuenta o solo en las que elijas, responden una sola vez por comentario y guardan un registro.
- Pide los permisos a MetaEn tu app de Meta, Revisión de la app → Permisos y funciones, solicita acceso avanzado a
instagram_manage_comments,pages_messagingypages_manage_metadata. Meta pide la verificación del negocio y un video corto que muestre el uso dentro de Blooma. - Márcalos en BloomaCuando Meta los apruebe, márcalos en Integraciones → App de Meta → “Permisos aprobados por Meta”.
- Reconecta las cuentasPulsa “Conectar Instagram” otra vez en cada cuenta: un permiso nuevo solo llega al reconectar.
- Activa la automatizaciónAl activarla, Blooma suscribe la página de la cuenta a los avisos de comentarios.
Instagram permite un solo mensaje privado por comentario, dentro de los 7 días siguientes, y como máximo 750 por hora por cuenta. Blooma se detiene antes de ese límite.
Google Drive
Las piezas del PDC pueden llevar uno o varios enlaces de Drive (cada uno es un slide). Blooma no copia los archivos: los muestra desde Drive y, al publicar, Meta recibe el original desde Drive a través de un enlace temporal de Blooma.
- Comparte cada archivo como “Cualquier persona con el enlace”. Blooma lo revisa al programar y te avisa si no lo está.
- Formatos que acepta Instagram: imágenes JPG y videos MP4 o MOV.
Llave de Google (recomendada)
- Crea un proyectoEn console.cloud.google.com, crea un proyecto para tu agencia.
- Activa la Google Drive APIEn APIs y servicios → Biblioteca, busca “Google Drive API” y actívala.
- Crea la clave de APIEn Credenciales → Crear credenciales → Clave de API. Edítala y, en Restricciones de API, deja solo la Google Drive API.
- Pégala en BloomaIntegraciones → Google Drive → Guardar llave. Queda cifrada y solo la usa tu organización.
Sin llave, Blooma usa la descarga pública de Drive. Funciona, pero con la llave la descarga es más estable.
Conectar WhatsApp
Cada número de WhatsApp Business se conecta a un espacio del CRM con la API de WhatsApp Cloud y la app de Meta de tu organización. Los datos se guardan cifrados. Blooma no cobra por mensaje; Meta cobra a tu cuenta según su modelo de precios.
¿Prefieres que te guíen? Copia el prompt para conectar WhatsApp y pégalo en ChatGPT, Claude o la IA que uses: te lleva paso a paso. Nunca le pegues tus tokens ni claves.
En Meta
- Prepara la appEn developers.facebook.com/apps abre (o crea) la app de tipo Empresa de tu organización y agrégale el producto WhatsApp.
- Copia los IDEn WhatsApp → Configuración de la API están el ID del número de teléfono (no es el número) y el ID de la cuenta de WhatsApp Business.
- Crea el token permanenteEn business.facebook.com/settings → Usuarios del sistema, crea uno (o usa el que tienes), dale acceso a la cuenta de WhatsApp y genera un token con
whatsapp_business_messagingywhatsapp_business_management. - Copia la clave secretaEn la app, Configuración → Básica → Clave secreta de la app.
En Blooma
- Enciende los módulosAjustes → Organización → Módulos: CRM y Bandeja del CRM.
- Conecta el númeroAjustes → Organización → Integraciones → WhatsApp (o CRM → Contactos y empresas del espacio) → Conectar número. Pega los 4 datos: Blooma los comprueba con Meta. Puedes elegir que cada contacto nuevo cree un lead.
- Configura el webhookBlooma te muestra la URL del webhook y el token de verificación. Pégalos en tu app: WhatsApp → Configuración → Webhook, verifica y suscribe el campo
messages. - Suscribe la cuentaVuelve a Blooma y pulsa Suscribir la cuenta a la app.
- PruebaEscríbele al número desde otro celular: el mensaje aparece en la Bandeja.
Si algo no funciona
| Síntoma | Qué revisar |
|---|---|
| “Meta no encontró ese dato” | Que pegaste el ID del número de teléfono y el ID de la cuenta de la Configuración de la API (no el número con +57), y que el token tenga acceso a esa cuenta. |
| “El token no tiene permiso” | Que el token sea de un usuario del sistema con whatsapp_business_messaging y whatsapp_business_management, y que el usuario tenga asignada la cuenta de WhatsApp. |
| “El token venció” | Genera un token permanente de usuario del sistema (los temporales vencen en horas) y actualízalo con Editar. |
| “Ese número ya está conectado en Blooma” | Un número vive en un solo espacio. Desconéctalo donde está y conéctalo en el nuevo. |
| No llegan mensajes a la Bandeja | Que el webhook esté verificado con el campo messages, que hayas pulsado Suscribir la cuenta a la app y que el módulo Bandeja del CRM esté encendido. |
| El número está en la app de WhatsApp del celular | Meta no deja usarlo en la API al mismo tiempo: usa otro número o pásalo a la API desde el Administrador de WhatsApp. |
| No puedo escribirle a alguien | Pasaron más de 24 horas desde su último mensaje: usa una plantilla aprobada. |
Instagram en la Bandeja
Los mensajes directos de una cuenta de Instagram entran a la Bandeja del espacio que elijas. No hay datos que pegar: Blooma usa la conexión que la cuenta ya tiene para publicar. Solo falta que tu app de Meta tenga el permiso de mensajes.
¿Prefieres que te guíen? Copia el prompt para Instagram y pégalo en ChatGPT, Claude o la IA que uses. Nunca le pegues tus tokens ni claves.
- Conecta la cuenta en BloomaSi aún no lo está, conéctala desde el calendario de contenido con Conectar con Meta (mira Conectar la publicación).
- Pide el permiso a MetaEn tu app de Meta, Revisión de la app, solicita
instagram_manage_messages. Meta pide un video que muestre cómo el equipo lee y responde los mensajes desde Blooma. - Suscribe el campo «messages»En Webhooks → objeto Instagram de tu app (la misma URL de los comentarios), marca también el campo
messages. La app debe estar publicada. - Márcalo en BloomaCuando Meta lo apruebe, márcalo en Ajustes → Organización → Integraciones → App de Meta y vuelve a conectar la cuenta.
- Conéctala a la BandejaEn Integraciones (o en Contactos y empresas del espacio), pulsa Conectar Instagram, elige la cuenta y, si quieres, el pipeline donde se crea un lead por cada persona nueva.
Si algo no funciona
| Síntoma | Qué revisar |
|---|---|
| “Falta el permiso instagram_manage_messages” | Que Meta lo haya aprobado, que esté marcado en Integraciones y que hayas reconectado la cuenta después de marcarlo. |
| No aparece la cuenta al conectar | Que esté conectada en Blooma y vinculada a una página de Facebook. Si dice “Reconéctala”, vuelve a conectarla desde el calendario de contenido. |
| “Ya atiende la Bandeja de otro espacio” | Una cuenta vive en un solo espacio. Desconéctala donde está y conéctala en el nuevo. |
| No llegan mensajes | Que el webhook de Instagram tenga el campo messages, que la app esté publicada y que el módulo Bandeja del CRM esté encendido. Con Suscribir la cuenta a la app Blooma vuelve a pedirle a Meta los mensajes de la cuenta. |
| No puedo responderle a alguien | Pasaron más de 24 horas desde su último mensaje: Instagram no deja escribirle hasta que vuelva a escribir. |
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
| Síntoma | Qué revisar |
|---|---|
| Blooma no acepta el token | Que el token sea del usuario del sistema, que tenga los cinco permisos y que no haya caducado. Genera uno nuevo y vuelve a pegarlo. |
| No aparece la cuenta de Instagram | Que sea una cuenta profesional, que esté vinculada a una página de Facebook y que el usuario del sistema tenga asignados la página y la cuenta. |
| No hay datos de pauta | Que el cliente tenga el ID de su cuenta publicitaria y que esa cuenta esté asignada al usuario del sistema. |
| El botón de publicar está deshabilitado | Revisa las reglas para publicar: la pieza necesita el copy aprobado y la aprobación final del cliente. |
| “Tu organización todavía no configuró su app de Meta” | Un administrador debe cargar el ID y la clave secreta en Ajustes → Organización → Integraciones. Mira La app de Meta de tu agencia. |
| “El archivo de Drive no está compartido” | En Drive, Compartir → “Cualquier persona con el enlace”. El archivo debe ser JPG, MP4 o MOV. |
| Las automatizaciones no responden | Que Meta haya aprobado los tres permisos, que estén marcados en Integraciones, que hayas reconectado la cuenta y que el webhook de tu app esté verificado con el campo comments. |
| La publicación falla | Que los archivos estén compartidos con el enlace (o en una URL pública), que la cuenta siga conectada y que no hayas llegado al límite de publicaciones de tu plan. |
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.
- Abre el PlannerPulsa Conectar en la tarjeta de Google Calendar.
- Autoriza con GoogleBlooma pide los permisos
openid,emailycalendar.events.owned(solo los eventos que crea Blooma). - ListoUsa “Sincronizar ahora” cuando quieras forzar una actualización, o desconecta desde el mismo lugar.
La sincronización va en un solo sentido: de Blooma a Google. Cubre desde el día anterior hasta 180 días adelante. Los eventos que ya tienes en Google no se importan al Planner.
Dile a tu IA que lo haga por ti
Copia uno de estos prompts y pégalo en ChatGPT, Claude, Gemini o la IA que uses: te guía paso a paso, preguntándote en qué vas. En Blooma encuentras los mismos prompts junto a cada integración.
Por seguridad, nunca pegues tokens, claves secretas ni contraseñas en una IA: esos datos van directo en Blooma, donde se guardan cifrados.
Conectar WhatsApp a la Bandeja
Actúa como mi asistente técnico. Quiero conectar el número de WhatsApp de mi negocio a Blooma (mi CRM) usando la API de WhatsApp Cloud de Meta. Guíame paso a paso, con los clics exactos en developers.facebook.com y business.facebook.com, para conseguir estos 4 datos que Blooma me pide:
1. El ID del número de teléfono (Phone Number ID; no es el número en sí).
2. El ID de la cuenta de WhatsApp Business (WABA ID).
3. Un token permanente creado con un usuario del sistema del Business Manager, con los permisos whatsapp_business_messaging y whatsapp_business_management, y con acceso a esa cuenta de WhatsApp.
4. La clave secreta de la app (App Secret), en Configuración de la app → Básica.
Después, cuando Blooma me muestre la URL del webhook y el token de verificación, explícame dónde pegarlos en la configuración de WhatsApp de mi app, cómo verificar el webhook y cómo suscribir el campo «messages».
Antes de empezar, pregúntame:
- si ya tengo una app en Meta for Developers o hay que crearla;
- si mi número está hoy en la app de WhatsApp o WhatsApp Business del celular (en ese caso explícame mis opciones: usar otro número o pasarlo a la API, y qué implica).
Ve de a un paso y espera a que te diga que lo terminé. Importante: nunca me pidas que te pegue tokens, claves secretas ni contraseñas; esos datos los pego yo directamente en Blooma.
Instagram en la Bandeja
Actúa como mi asistente técnico. Quiero que los mensajes directos de la cuenta de Instagram de mi negocio lleguen a Blooma (mi CRM), usando la app de Meta de mi organización (Messenger API for Instagram). La cuenta ya está conectada en Blooma con Facebook. Guíame paso a paso en developers.facebook.com para:
1. Agregar a mi app el producto de mensajería de Instagram, si aún no lo tiene.
2. Pedir en App Review el permiso instagram_manage_messages: qué escribir en la descripción de uso y qué mostrar en el video (Blooma lee los mensajes directos y el equipo responde desde su bandeja).
3. En Webhooks → Instagram, suscribir el campo «messages» (además de «comments», si ya lo tengo).
4. Confirmar que la app esté publicada (sin publicar, Meta no manda los avisos).
Cuando Meta apruebe el permiso, recuérdame marcarlo en Blooma (Ajustes → Organización → Integraciones), volver a conectar la cuenta y, en el espacio del CRM, tocar «Conectar Instagram».
Ve de a un paso y pregúntame en qué voy. Importante: nunca me pidas que te pegue tokens, claves secretas ni contraseñas; esos datos los pego yo directamente en Blooma.
Crear la app de Meta de tu agencia
Actúa como mi asistente técnico. Quiero crear la app de Meta de mi agencia para que Blooma publique en Instagram y responda comentarios. Guíame paso a paso en developers.facebook.com para:
1. Crear una app de tipo Empresa y agregarle Inicio de sesión con Facebook e Instagram.
2. Encontrar el ID de la app y la clave secreta (Configuración → Básica) para pegarlos en Blooma.
3. Pegar la URL de redirección que me da Blooma en Inicio de sesión con Facebook → URI de redirección de OAuth válidos.
4. Configurar el webhook de Instagram con la URL y el token de verificación que me da Blooma, y suscribir el campo «comments».
5. Pedir en App Review los permisos instagram_manage_comments, pages_messaging y pages_manage_metadata, y qué debo mostrar en el video de revisión.
Ve de a un paso y pregúntame en qué voy. Importante: nunca me pidas que te pegue tokens, claves secretas ni contraseñas; esos datos los pego yo directamente en Blooma.
Conectar métricas e Insights de Meta
Actúa como mi asistente técnico. Quiero conectar las métricas de Instagram, Facebook y pauta de mis clientes a Blooma con un token de Meta. Guíame paso a paso en business.facebook.com/settings para:
1. Crear un usuario del sistema con rol de administrador.
2. Asignarle las páginas de Facebook, las cuentas de Instagram y, si quiero ver pauta, las cuentas publicitarias de mis clientes.
3. Generar un token con mi app marcando instagram_basic, instagram_manage_insights, pages_read_engagement, read_insights y, para pauta, ads_read.
Blooma solo lee métricas: no publica ni cambia pautas. Ve de a un paso y pregúntame en qué voy. Importante: nunca me pidas que te pegue tokens, claves secretas ni contraseñas; esos datos los pego yo directamente en Blooma.
Llave de Google Drive
Actúa como mi asistente técnico. Necesito una clave de API de Google Drive para que Blooma muestre los archivos de mis piezas de contenido. Guíame paso a paso en console.cloud.google.com para:
1. Crear un proyecto (o elegir uno).
2. Activar la Google Drive API.
3. Crear una clave de API en Credenciales y restringirla solo a la Google Drive API.
4. Revisar que los archivos estén compartidos como «Cualquier persona con el enlace».
Ve de a un paso y pregúntame en qué voy. Importante: nunca me pidas que te pegue tokens, claves secretas ni contraseñas; esos datos los pego yo directamente en Blooma.
Redactar la Información para la IA
Actúa como redactor de mi negocio. Voy a pegarte información que ya tengo (texto de mi página web, menú o catálogo, políticas, preguntas que me hacen los clientes). Con eso, escribe un texto corto y claro para cada una de estas secciones de mi CRM, que después leerá la IA que atiende a mis clientes por WhatsApp:
- Sobre el negocio
- Horario de atención
- Dirección y cobertura
- Catálogo, menú o servicios y precios
- Medios de pago
- Políticas
- Preguntas frecuentes
- Tono y reglas para la IA
Reglas:
- Frases simples y concretas, como se las diría a un cliente.
- No inventes precios, horarios ni políticas: si algo no está en lo que te pegué, escribe «PENDIENTE: …» con la pregunta que debo responder.
- En «Tono y reglas para la IA», propón cómo debe escribir (tú o usted, emojis, largo) y cuándo pasar la conversación a una persona.
- Entrégame cada sección con su título, lista para copiar y pegar.
Cuando estés listo, dime «Pégame tu información» y espera.
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.
- Los archivos están en Drive compartidos como “Cualquier persona con el enlace” (JPG, MP4 o MOV) o en una URL pública.
- 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 20 elementos), reel (también de prueba) 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?
Hoy Blooma no ofrece una API pública, llaves de API ni webhooks salientes para terceros. Si necesitas integrar Blooma con otro sistema, cuéntanos tu caso.
Llamadas a Meta
Estas son las operaciones que Blooma hace contra las APIs oficiales de Meta, con el token de tu organización:
| Para qué | Operación | Tipo |
|---|---|---|
| Analizar una cuenta de Instagram | business_discovery | Lectura |
| Métricas de la cuenta | GET /<IG_USER_ID>/insights | Lectura |
| Métricas de cada publicación | GET /<IG_MEDIA_ID>/insights | Lectura |
| Separar orgánico y pauta | breakdown=media_product_type | Lectura |
| Resultados de pauta | GET /act_<AD_ACCOUNT_ID>/insights | Solo lectura |
| Publicar en Instagram | POST /<IG_USER_ID>/media y /media_publish | Escritura (solo publicación) |
| Esperar a que un video esté listo | GET /<IG_CONTAINER_ID>?fields=status_code | Lectura |
| Desactivar comentarios al publicar | POST /<IG_MEDIA_ID>?comment_enabled=false | Escritura (opcional) |
| Responder un comentario (automatizaciones) | POST /<IG_COMMENT_ID>/replies | Escritura |
| Mensaje privado a quien comentó | POST /<PAGE_ID>/messages con comment_id | Escritura |
| Recibir avisos de comentarios | POST /<PAGE_ID>/subscribed_apps | Configuració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: cada organización tiene su propia URL de webhook (la ves en Integraciones). Blooma verifica la firma HMAC con la clave secreta de la app de esa organización, registra cada evento y, con los comentarios, ejecuta las automatizaciones de esa organización.
- 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
| Plan | Personas | Módulos que suma | Clientes | Publicaciones al mes |
|---|---|---|---|---|
| Free | 1 a 3 | Dashboard, Manager, Tracking, Chat y Clientes | 5 | No incluye |
| Starter | 4 a 10 | Planner, PDC Calendar e Insights | 15 | 30 |
| Pro | 11 a 25 | Analytics y portal de cliente | 50 | 100 |
| Agency | 26 o más | White-label, dominio propio y hasta 5 organizaciones | 200 | 500 |
Los precios actualizados están en la sección de precios.
Glosario
| PDC | Plan de contenidos de un cliente para un mes. |
| Usuario del sistema | Usuario técnico de Meta Business que no depende de una persona. Se usa para generar tokens estables. |
| Token | Credencial que autoriza a Blooma a consultar Meta en nombre de tu organización. |
| Orgánico / pauta | Resultados de las publicaciones sin inversión frente a los que vienen de anuncios. |
| White-label | Portal de cliente sin la marca Blooma (plan Agency). |
¿No encontraste lo que buscabas? Escríbenos y te ayudamos.
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.
| Documento | Qué regula |
|---|---|
| Términos y Condiciones de Uso | Las reglas para usar Blooma: cuentas, contenido, integraciones, responsabilidad y terminación. |
| Política de Privacidad y Tratamiento de Datos Personales | Cómo tratamos los datos personales conforme a la Ley 1581 de 2012 y cómo ejercer sus derechos. |
| Términos de Suscripción, Pagos y Reembolsos | Planes, renovación automática, prueba gratuita, mora, cancelación, reembolsos y facturación. |
| Términos de las Aplicaciones Móviles (iOS y Android) | Licencia de uso de las apps de Blooma para iOS y Android, permisos del dispositivo y soporte. |
| Integraciones, Datos de Terceros e Inteligencia Artificial | Qué datos obtenemos de Meta y Google, su uso limitado y cómo funcionan las funciones de IA. |
| Política de Cookies y Tecnologías Similares | Qué cookies y tecnologías similares usamos y cómo controlarlas. |
| Política de Publicidad y Comunicaciones Comerciales | Comunicaciones comerciales de Blooma y responsabilidad de los Suscriptores por su publicidad. |
| Política de Uso Aceptable | Contenidos y conductas prohibidas en Blooma y consecuencias de su incumplimiento. |
| Acuerdo de Encargo del Tratamiento de Datos | Cómo trata Blooma, como encargado, los datos que las agencias cargan sobre sus clientes. |
| Proveedores y Subencargados | Los proveedores que tratan datos para prestar Blooma y dónde operan. |
| Eliminación de Cuenta y Datos | Cómo eliminar su cuenta, su Organización y los datos obtenidos de Meta y Google. |
| Política de Propiedad Intelectual | Derechos sobre Blooma y procedimiento para reportar presuntas infracciones. |
| Seguridad y Divulgación Responsable | Cómo protegemos la información y cómo reportar vulnerabilidades. |
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.