Integración Blooio n8nAutomatiza Blooio con n8n.

La llamada describe la clave de API que lleva el credential: la organización asociada, los dispositivos declarados y las estadísticas de uso registradas. No pide ningún parámetro, así que es la petición más ligera del nodo.

Una conversación, una respuesta: el nodo devuelve la ficha del hilo indicado, sin el historial de mensajes.

• Chat: el identificador de conversación, ya sea un número en formato E.164, un correo, un identificador de grupo grp_abc123, o varios destinatarios separados por comas. Suele ser {{ $json.chatId }} desde un nodo anterior.

Una conversación puede llevar una imagen de fondo. Esta operación devuelve los metadatos de la que está puesta, suficiente para saber si un hilo se personalizó o se dejó tal cual.

• Chat: el identificador de conversación que usa todo el nodo, número, correo, identificador de grupo o lista de destinatarios.

Todas las conversaciones vuelven en un único conjunto, con las más recientes al principio por defecto. Es la puerta de entrada cuando un flujo trabaja sobre varios hilos a la vez.

• Limit: el número máximo de resultados que devuelve la llamada.
• Offset: cuántos elementos saltar, que es como se llega a la página siguiente.
• Search Query: busca por número, por correo o por nombre de contacto.
• Sort: recent u oldest.

Todos los mensajes del hilo pasan a leídos y sale una confirmación de lectura hacia la otra persona. El efecto se ve al otro lado, no es un simple orden interno.

• Chat: la conversación que hay que saldar, como número, correo, identificador de grupo o destinatarios separados por comas.

La imagen de fondo se retira de la conversación, que vuelve a su aspecto por defecto. Aquí no hay sustitución, solo retirada.

• Chat: el identificador de la conversación que hay que dejar limpia, número, correo, identificador de grupo o varios destinatarios.

La tarjeta de contacto, esto es la identidad Name and Photo, queda preparada para viajar con el siguiente mensaje saliente. La llamada por sí sola no envía nada. Solo en planes Dedicated Commercial y Enterprise.

• Chat: dónde preparar la tarjeta, como número, correo, identificador de grupo o lista de destinatarios.

La agenda vuelve en forma de items, con búsqueda y paginación en la misma llamada.

• Limit: pone techo al número de contactos por ejecución.
• Offset: salta los que ya se trataron, para una segunda o tercera pasada.
• Search Query: busca por identificador o por nombre.
• Sort: recent, oldest, name_asc o name_desc.

Un contacto nace de un único identificador. El nombre visible es opcional, así que un flujo puede registrar primero el número y enriquecerlo más tarde.

• Identifier: un número en formato E.164, por ejemplo +15551234567, o una dirección de correo. Obligatorio.
• Name: el nombre visible del contacto.

Apunta a una persona y el nodo devuelve su ficha, sola.

• Contact: el identificador del contacto, número en formato E.164 o correo electrónico. El campo espera ese identificador, no un id interno guardado en otro sistema.

Aquí cambia una sola cosa: el nombre visible de un contacto que ya existe. Dejar el campo vacío borra el valor en lugar de conservar el anterior.

• Contact: el número en formato E.164 o el correo que identifica la ficha.
• Name: el nuevo nombre visible, vacío para borrarlo.

La ficha del contacto desaparece. Conviene lanzarla desde una rama controlada, porque el nodo no pide ninguna segunda confirmación.

• Contact: el identificador de la ficha que hay que borrar, número en formato E.164 o correo.

Blooio responde si esa persona es alcanzable por iMessage, por SMS, por FaceTime o por alguna combinación de las tres. La respuesta condiciona lo que puedes enviarle.

• Contact: el número en formato E.164 o el correo que se quiere comprobar.

Lado de lectura del sistema de etiquetas: la llamada devuelve las que lleva puestas un contacto, nada más.

• Contact: el identificador del contacto, número en formato E.164 o dirección de correo.

Las etiquetas son libres, así que el vocabulario lo defines tú, y mantenerlo coherente también te toca. Varias pueden salir en la misma llamada.

• Contact: el número en formato E.164 o el correo de la persona que se etiqueta.
• Tags: las etiquetas libres que hay que añadir, escritas con el control Add Tag.

Cae una etiqueta y las demás siguen ahí. La operación es a propósito más estrecha que la de añadir, que acepta varias de golpe.

• Contact: el identificador de la persona, número en formato E.164 o correo.
• Tag: la etiqueta concreta que se retira.

Vuelven todos los grupos conocidos por la cuenta, con los mismos controles de búsqueda y paginación que las demás listas.

• Limit: el número máximo de grupos por ejecución.
• Offset: cuántos grupos saltar antes de leer.
• Search Query: busca por el nombre del grupo.
• Sort: recent, oldest, name_asc o name_desc.

Un grupo se crea a partir de un nombre, y puede vivir por su cuenta o quedar enganchado a una conversación de iMessage que ya existe.

• Name: el nombre del grupo, hasta 255 caracteres. Obligatorio.
• Chat GUID: un GUID de chat de BlueBubbles del tipo iMessage;+;chat123, para enlazar el grupo con un hilo de iMessage existente.
• Members: los números o correos de los contactos que entran.

Vuelve la ficha de un grupo, buscada por su identificador y no por su nombre, porque los nombres no son únicos.

• Group ID: el identificador con forma grp_abc123, normalmente {{ $json.id }} arrastrado desde el paso de creación.

Renombrar es todo lo que hace esta operación. La composición se gestiona en otro sitio, aquí no se mueve ningún miembro.

• Group ID: el identificador grp_abc123 del grupo que se renombra.
• Name: el nuevo nombre del grupo. Obligatorio igual que el identificador.

El grupo se retira de la cuenta. No hay nada más en la llamada, lo que la vuelve fácil de disparar por error sobre el identificador equivocado.

• Group ID: el identificador grp_abc123 del grupo que se borra.

Sale la composición de un grupo, y se pagina como las demás colecciones en lugar de volcarlo todo de una vez.

• Group ID: el identificador grp_abc123 del grupo que se inspecciona.
• Limit: cuántos miembros vuelven por llamada.
• Offset: cuántos miembros saltar para leer la página siguiente.

Las posiciones FindMy que Blooio ya guarda en caché para tus contactos salen en una sola lista. La llamada lee la caché y no despierta los dispositivos, así que resulta ligera de repetir y no pide ningún parámetro.

Vuelve la posición en caché de un solo contacto, identificada por su handle y no por un ID interno.

• Handle: el número del contacto en formato E.164 o su dirección de correo.

Aquí no vuelve nada: la llamada pide a Blooio que actualice las posiciones FindMy en caché. No hay parámetros que rellenar y encadena de forma natural con las operaciones de lectura colocadas detrás.

La operación central del nodo: un texto, un adjunto, o ambos, entregados en una conversación.

• Chat: un número como +15551234567, un correo, un identificador de grupo, o una lista de destinatarios separados por comas.
• Text: el cuerpo del mensaje.
• Attachments: URL públicas de imágenes, vídeos o archivos.
• Idempotency Key: al reutilizarla, devuelve el resultado original en vez de enviar dos veces.
• Effect: un efecto de envío de iMessage, ignorado en SMS y RCS.

Llegan los detalles de un mensaje concreto, lo que evita listar un hilo entero para recuperar lo que se envió o se recibió.

• Chat: la conversación a la que pertenece el mensaje.
• Message ID: el identificador msg_abc123 del mensaje.

Enviado no significa entregado. Esta llamada responde a la segunda pregunta e indica en qué punto está un mensaje concreto.

• Chat: la conversación que contiene el mensaje.
• Message ID: el msg_abc123 cuyo estado te interesa.

Los mensajes de una conversación salen como colección filtrable y paginada, donde la operación Get solo devuelve uno.

• Chat: la conversación que se lee.
• Limit y Offset: el tamaño de página y cuántos elementos saltar.
• Direction: inbound o outbound.
• Since (Ms Timestamp) y Until (Ms Timestamp): marcas de tiempo Unix en milisegundos que acotan la ventana.
• Sort: desc para los más recientes, asc para los más antiguos.

Todos los números vinculados a la clave de API vuelven en un array, sin nada que ajustar en el nodo. Es la llamada de inventario en cuanto se emite desde varias líneas.

Las llamadas que entran en uno de tus números pueden salir hacia otra línea. La operación abre la solicitud, no activa el desvío por sí sola.

• Number: el número de origen en formato E.164.
• Forward To: el número estadounidense de destino que debe recibir las llamadas, con E.164 recomendado.

La identidad Name y Photo que muestra un número se ajusta aquí, y solo los planes Dedicated tienen acceso.

• Number: el número de origen en formato E.164 cuya tarjeta cambia.
• First Name y Last Name: la identidad que ven los destinatarios.
• Avatar (Base64): la foto de perfil en JPEG o PNG codificado en base64.
• Sharing Enabled: si esa identidad se comparte o no.

Validación y formato de un número, con geocodificación, de uno en uno. Requiere un plan Dedicated Enterprise.

• Number: el número que se comprueba, en E.164, en notación nacional o ya formateado.

La misma comprobación, pero al por mayor: hasta 100 números viajan en una sola petición, lo que evita convertir una importación en un bucle largo.

• Numbers: la lista de números que se comprueban, 100 como máximo por llamada. Requiere un plan Dedicated Enterprise.

Se publica una encuesta nativa de iMessage en una conversación: las respuestas llegan como votos y no como texto libre que alguien tenga que leer.

• Chat: la conversación, ya sea número, correo o identificador de grupo.
• Options: entre 2 y 10 respuestas propuestas.
• Title: la pregunta que aparece encima de las opciones.

La definición de una encuesta y el recuento agregado de votos vuelven juntos.

• Chat: la conversación donde se publicó la encuesta.
• Poll ID: el identificador que trae el evento webhook poll.created o poll.received.

Tapbacks y emoji pasan por la misma operación, que quita con la misma facilidad con la que añade.

• Message ID: un msg_abc123, o un índice relativo donde -1 señala el último mensaje.
• Reaction: con prefijo + para añadir o - para quitar, con un tapback clásico como love o laugh, o cualquier emoji.
• Chat: la conversación que contiene ese mensaje.
• Direction: inbound u outbound, útil solo cuando el índice es relativo.

El indicador de escritura aparece en el hilo y le regala a un bot la pausa que un humano tardaría en contestar. Solo iMessage.

• Chat: la conversación donde se muestra el indicador, como número, correo o identificador de grupo.

La llamada gemela oculta el indicador, y cuenta sobre todo cuando la rama que lo lanzó acaba mal.

• Chat: el mismo identificador de conversación que recibió la operación de inicio.

Todos los webhooks registrados en la cuenta vuelven en un array, sin parámetros que rellenar. Es el punto de partida de cualquier flujo que mantenga las suscripciones en lugar de crearlas a mano.

Se registra una suscripción: Blooio empieza a publicar sus eventos hacia la URL indicada.

• Webhook URL: el endpoint que recibe los eventos, a menudo la URL de producción de un nodo Webhook de n8n.
• Webhook Type: message, status o all.
• Valid Until: una marca de expiración en milisegundos, o -1 para que no caduque.

Se relee una suscripción concreta a partir de su identificador, que es como un flujo comprueba para qué está configurado realmente un endpoint.

• Webhook ID: el identificador wh_abc123 de la suscripción.

Una suscripción existente cambia sobre la marcha, sin tocar el identificador que otros sistemas ya conocen.

• Webhook ID: el wh_abc123 que se modifica.
• Webhook Type: pasar el flujo a message, status o all.
• Valid Until: alejar la marca de expiración en milisegundos, o -1 para quitarla.
• Deprecate: true marca el webhook como obsoleto, false lo reactiva.

La suscripción desaparece para siempre y las entregas hacia su URL se detienen.

• Webhook ID: el wh_abc123 que se elimina.

Se genera un nuevo secreto de firma para la suscripción, y solo se muestra una vez, en la respuesta de esta llamada.

• Webhook ID: el wh_abc123 cuyo secreto se sustituye.

Los intentos de entrega de una suscripción se listan aquí, y es donde se mira cuando se sospecha que un endpoint pierde eventos.

• Webhook ID: la suscripción cuyas entregas se leen.
• Limit y Offset: tamaño de página y cuántas entradas saltar.
• Status, Min Status y Max Status: filtrar por un código HTTP exacto o por un rango.
• Sort: desc para las más recientes, asc para las más antiguas.

Un evento ya entregado sale de nuevo hacia el mismo endpoint, lo que ahorra reproducir la conversación original solo para recuperar su carga útil.

• Webhook ID: la suscripción que había entregado el evento.
• Event ID: el identificador del evento que se reenvía.