Saltar al contenido
Inicio Funciones Agencias Precios Nosotros Documentación Contacto
Empezar gratis Iniciar sesión
Documentación

Aprende a usar Blooma.

Primeros pasos, cómo usar cada módulo (tableros, sprints, CRM con Bandeja de WhatsApp y plantillas por industria, documentos, objetivos, formularios, automatizaciones y más), las integraciones, prompts para que tu IA te guíe y cómo funcionan las APIs de Blooma.

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

ConceptoQué es
OrganizaciónEl espacio de trabajo de tu empresa o equipo. Sus datos están aislados de otras organizaciones. Una persona puede pertenecer a varias.
Miembro y rolCada 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óduloCada 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.
PDCPlan de contenidos de un cliente para un mes. Contiene las piezas (reel, post, carrusel, historia, video, short, tweet o artículo).
Tablero y tarjetaEl Manager organiza el trabajo en tableros con columnas y tarjetas.
BloqueUna franja de tiempo planificada en el Planner para una persona y una tarea, con la etapa del tablero en la que se trabaja.
SprintUn periodo corto (dos semanas por defecto) con un objetivo y las tarjetas que el equipo se compromete a terminar.
LeadUna oportunidad en el CRM, con su etapa, valor y bitácora.

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 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.
  3. Invita a tu equipoDesde Configuración → Organización, invita a las personas y asígnales un rol.
  4. Arma tu primer tableroEn el Manager, crea un tablero desde una plantilla por metodología o importa el que ya tienes.
  5. Planifica la semanaAsigna tarjetas y planifícalas en el Planner; si trabajas por sprints, arma el primero en Sprints.
  6. 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+O en Mac o Ctrl+Shift+O en 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

  1. 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).
  2. 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.
  3. InícialoSolo puede haber un sprint en curso por tablero. Mover una tarjeta en el tablero del sprint la mueve en el Manager.
  4. 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

ReglaQué hace Blooma
Ventana de 24 horasPuedes 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 marketingSi 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 2023Las 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 entregaCada mensaje muestra enviado, entregado o leído; si WhatsApp no lo entrega, ves el motivo.
InstagramPuedes 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.

PlantillaEtapas
RestauranteNuevo 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 agenciaProspecto → Reunión agendada → Propuesta enviada → Negociación → Ganado / Perdido
Salud y estéticaSolicitud → Cita agendada → Confirmada → Atendida / No asistió o canceló
InmobiliariaInteresado → Calificado → Visita agendada → Oferta o documentos → Cerrado / Descartado
Educación y cursosInteresado → 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, /pagos o /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

  1. Crea el formularioEn Formularios, agrega campos (texto, correo, teléfono, número, selección, casilla) y elige a qué dato va cada uno.
  2. 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.
  3. 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.

CuandoEntonces
Una tarjeta entra a una columna, se crea o se completaAsignar 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 Insights2 · 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 conectaToken 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óndeAjustes → 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.
Permisosinstagram_basic, instagram_manage_insights, pages_read_engagement, read_insights, ads_readinstagram_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

  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.

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

  1. 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.
  2. Agrega los productosAgrega Inicio de sesión con Facebook y la API de Instagram con inicio de sesión de Facebook.
  3. 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

  1. Abre IntegracionesVe a Ajustes → Organización → pestaña Integraciones → “App de Meta”.
  2. Pega el ID y la clave secretaPulsa Guardar app de Meta. La clave queda cifrada y en pantalla solo ves sus últimos 4 caracteres.
  3. 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.
  4. 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.
  5. 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”.

  1. Abre un PDCEn el panel “Publicación en Instagram” (o en el paso “Redes del cliente” al crear el PDC), 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”.

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_comments aprobado.
  • 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.

  1. 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_messaging y pages_manage_metadata. Meta pide la verificación del negocio y un video corto que muestre el uso dentro de Blooma.
  2. Márcalos en BloomaCuando Meta los apruebe, márcalos en Integraciones → App de Meta → “Permisos aprobados por Meta”.
  3. Reconecta las cuentasPulsa “Conectar Instagram” otra vez en cada cuenta: un permiso nuevo solo llega al reconectar.
  4. 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)

  1. Crea un proyectoEn console.cloud.google.com, crea un proyecto para tu agencia.
  2. Activa la Google Drive APIEn APIs y servicios → Biblioteca, busca “Google Drive API” y actívala.
  3. Crea la clave de APIEn Credenciales → Crear credenciales → Clave de API. Edítala y, en Restricciones de API, deja solo la Google Drive API.
  4. 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

  1. 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.
  2. 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.
  3. 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_messaging y whatsapp_business_management.
  4. Copia la clave secretaEn la app, Configuración → Básica → Clave secreta de la app.

En Blooma

  1. Enciende los módulosAjustes → Organización → Módulos: CRM y Bandeja del CRM.
  2. 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.
  3. 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.
  4. Suscribe la cuentaVuelve a Blooma y pulsa Suscribir la cuenta a la app.
  5. PruebaEscríbele al número desde otro celular: el mensaje aparece en la Bandeja.

Si algo no funciona

SíntomaQué 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 BandejaQue 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 celularMeta 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 alguienPasaron 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.

  1. 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).
  2. 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.
  3. 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.
  4. Márcalo en BloomaCuando Meta lo apruebe, márcalo en Ajustes → Organización → Integraciones → App de Meta y vuelve a conectar la cuenta.
  5. 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íntomaQué 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 conectarQue 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 mensajesQue 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 alguienPasaron 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íntomaQué revisar
Blooma no acepta el tokenQue 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 InstagramQue 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 pautaQue 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á deshabilitadoRevisa 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 respondenQue 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 fallaQue 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.

  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.

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ónTipo
Analizar una cuenta de Instagrambusiness_discoveryLectura
Métricas de la cuentaGET /<IG_USER_ID>/insightsLectura
Métricas de cada publicaciónGET /<IG_MEDIA_ID>/insightsLectura
Separar orgánico y pautabreakdown=media_product_typeLectura
Resultados de pautaGET /act_<AD_ACCOUNT_ID>/insightsSolo lectura
Publicar en InstagramPOST /<IG_USER_ID>/media y /media_publishEscritura (solo publicación)
Esperar a que un video esté listoGET /<IG_CONTAINER_ID>?fields=status_codeLectura
Desactivar comentarios al publicarPOST /<IG_MEDIA_ID>?comment_enabled=falseEscritura (opcional)
Responder un comentario (automatizaciones)POST /<IG_COMMENT_ID>/repliesEscritura
Mensaje privado a quien comentóPOST /<PAGE_ID>/messages con comment_idEscritura
Recibir avisos de comentariosPOST /<PAGE_ID>/subscribed_appsConfiguració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

PlanPersonasMódulos que sumaClientesPublicaciones al mes
Free1 a 3Dashboard, Manager, Tracking, Chat y Clientes5No incluye
Starter4 a 10Planner, PDC Calendar e Insights1530
Pro11 a 25Analytics y portal de cliente50100
Agency26 o másWhite-label, dominio propio y hasta 5 organizaciones200500

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

Glosario

PDCPlan de contenidos de un cliente para un mes.
Usuario del sistemaUsuario técnico de Meta Business que no depende de una persona. Se usa para generar tokens estables.
TokenCredencial que autoriza a Blooma a consultar Meta en nombre de tu organización.
Orgánico / pautaResultados de las publicaciones sin inversión frente a los que vienen de anuncios.
White-labelPortal de cliente sin la marca Blooma (plan Agency).

¿No encontraste lo que buscabas? Escríbenos y te ayudamos.