Intégration Blooio n8nAutomatiser Blooio avec n8n.

L'appel décrit la clé d'API portée par le credential : l'organisation rattachée, les appareils déclarés et les statistiques d'usage enregistrées. Aucun paramètre à remplir, c'est la requête la plus légère du nœud.

Une conversation, une réponse : le nœud renvoie la fiche du fil visé, sans l'historique des messages.

• Chat : l'identifiant de conversation, soit un numéro au format E.164, soit une adresse mail, soit un identifiant de groupe grp_abc123, soit plusieurs destinataires séparés par des virgules. Souvent {{ $json.chatId }} venu d'un nœud précédent.

Une conversation peut porter une image de fond. Cette opération renvoie les métadonnées de celle qui est en place, de quoi savoir si un fil a été habillé ou laissé brut.

• Chat : l'identifiant de conversation utilisé partout dans le nœud, numéro, adresse mail, identifiant de groupe ou liste de destinataires.

Toutes les conversations reviennent dans un seul tableau, les plus récentes en tête par défaut. C'est le point d'entrée dès qu'un workflow travaille sur plusieurs fils à la fois.

• Limit : le nombre maximal de résultats renvoyés par l'appel.
• Offset : le nombre d'éléments à sauter, donc le moyen d'atteindre la page suivante.
• Search Query : recherche sur un numéro, une adresse mail ou un nom de contact.
• Sort : recent ou oldest.

Tous les messages du fil passent en lu, et un accusé de lecture repart vers l'interlocuteur. L'effet est visible côté destinataire, ce n'est pas un simple rangement interne.

• Chat : la conversation à solder, sous forme de numéro, d'adresse mail, d'identifiant de groupe ou de destinataires séparés par des virgules.

L'image de fond est retirée de la conversation, qui reprend son apparence par défaut. Aucune notion de remplacement ici, seulement le retrait.

• Chat : l'identifiant de la conversation à remettre à zéro, numéro, adresse mail, identifiant de groupe ou plusieurs destinataires.

La carte de visite, c'est-à-dire l'identité Name and Photo, est préparée pour accompagner le prochain message sortant. L'appel n'envoie rien par lui-même. Réservé aux plans Dedicated Commercial et Enterprise.

• Chat : l'endroit où préparer la carte, numéro, adresse mail, identifiant de groupe ou liste de destinataires.

Le carnet d'adresses remonte sous forme d'items, avec recherche et pagination sur le même appel.

• Limit : plafonne le nombre de contacts rapportés par exécution.
• Offset : saute ceux déjà traités, pour une deuxième ou troisième passe.
• Search Query : recherche sur l'identifiant ou le nom.
• Sort : recent, oldest, name_asc ou name_desc.

Un contact naît d'un seul identifiant. Le nom affiché reste facultatif, donc un workflow peut enregistrer un numéro d'abord et l'enrichir plus tard.

• Identifier : un numéro au format E.164, par exemple +15551234567, ou une adresse mail. Requis.
• Name : le nom affiché pour ce contact.

Vise une personne, le nœud renvoie sa fiche, seule, sans les messages ni les groupes auxquels elle appartient.

• Contact : l'identifiant du contact, numéro au format E.164 ou adresse mail. Le champ attend bien cet identifiant, pas un identifiant interne stocké ailleurs.

Une seule chose change ici : le nom affiché d'un contact existant. Laisser le champ vide efface la valeur au lieu de conserver l'ancienne.

• Contact : le numéro au format E.164 ou l'adresse mail qui identifie la fiche.
• Name : le nouveau nom affiché, vide pour l'effacer.

La fiche contact disparaît. À lancer depuis une branche maîtrisée : le nœud ne demande aucune seconde confirmation.

• Contact : l'identifiant de la fiche à supprimer, numéro au format E.164 ou adresse mail.

Blooio répond si la personne est joignable en iMessage, en SMS, en FaceTime, ou selon une combinaison des trois. La réponse conditionne ce que tu as le droit d'envoyer.

• Contact : le numéro au format E.164 ou l'adresse mail à tester.

Côté lecture du système de tags : l'appel renvoie les étiquettes actuellement posées sur un contact, rien de plus.

• Contact : l'identifiant du contact, numéro au format E.164 ou adresse mail.

Les tags sont libres, donc le vocabulaire t'appartient, et sa cohérence aussi. Plusieurs étiquettes peuvent partir dans le même appel.

• Contact : le numéro au format E.164 ou l'adresse mail de la personne à taguer.
• Tags : les tags libres à ajouter, saisis via le contrôle Add Tag.

Une étiquette saute, les autres restent. L'opération est volontairement plus étroite que l'ajout, qui en accepte plusieurs d'un coup.

• Contact : l'identifiant de la personne, numéro au format E.164 ou adresse mail.
• Tag : l'étiquette unique à retirer.

Tous les groupes connus du compte remontent, avec les mêmes contrôles de recherche et de pagination que les autres listes.

• Limit : le nombre maximal de groupes par exécution.
• Offset : le nombre de groupes à sauter avant lecture.
• Search Query : recherche sur le nom du groupe.
• Sort : recent, oldest, name_asc ou name_desc.

Un groupe se crée à partir d'un nom, et peut soit vivre seul, soit se rattacher à une conversation iMessage qui existe déjà.

• Name : le nom du groupe, jusqu'à 255 caractères. Requis.
• Chat GUID : un GUID de chat BlueBubbles du type iMessage;+;chat123, pour relier le groupe à un fil iMessage existant.
• Members : les numéros ou adresses mail des contacts à inclure.

La fiche d'un groupe revient, adressée par son identifiant et non par son nom, puisque les noms ne sont pas uniques.

• Group ID : l'identifiant au format grp_abc123, en général {{ $json.id }} repris de l'étape de création.

Renommer, c'est tout ce que fait cette opération. La composition se gère ailleurs, rien ne bouge côté membres.

• Group ID : l'identifiant grp_abc123 du groupe à renommer.
• Name : le nouveau nom du groupe. Requis au même titre que l'identifiant.

Le groupe est retiré du compte. Rien d'autre dans l'appel, ce qui le rend facile à déclencher par erreur sur le mauvais identifiant.

• Group ID : l'identifiant grp_abc123 du groupe à supprimer.

La composition d'un groupe remonte, et elle se pagine comme les autres collections plutôt que de tout déverser d'un coup.

• Group ID : l'identifiant grp_abc123 du groupe à inspecter.
• Limit : le nombre de membres rapportés par appel.
• Offset : le nombre de membres à sauter pour lire la page suivante.

Les positions FindMy déjà mises en cache par Blooio pour tes contacts remontent en une seule liste. L'appel lit le cache et ne réveille pas les appareils, ce qui le rend assez léger pour tourner souvent, et il ne demande aucun paramètre.

La position en cache d'un seul contact est renvoyée, désignée par son handle plutôt que par un identifiant interne.

• Handle : le numéro du contact au format E.164 ou son adresse mail.

Ici rien ne remonte : l'appel demande à Blooio de rafraîchir les positions FindMy en cache. Aucun paramètre à remplir, et il s'enchaîne naturellement avec les opérations de lecture placées après lui dans la même branche.

L'opération centrale du nœud : un texte, une pièce jointe, ou les deux, déposés dans une conversation.

• Chat : un numéro comme +15551234567, une adresse mail, un identifiant de groupe, ou une liste de destinataires séparés par des virgules.
• Text : le corps du message.
• Attachments : des URL publiques d'images, de vidéos ou de fichiers.
• Idempotency Key : réutilisée, la clé renvoie le résultat d'origine au lieu d'envoyer deux fois.
• Effect : un effet d'envoi iMessage, ignoré en SMS et en RCS.

Les détails d'un message précis reviennent, ce qui évite de lister tout un fil pour retrouver ce qui a été envoyé ou reçu.

• Chat : la conversation à laquelle appartient le message.
• Message ID : l'identifiant msg_abc123 du message.

Envoyé ne veut pas dire délivré. Cet appel répond à la seconde question et indique où en est un message donné.

• Chat : la conversation qui porte le message.
• Message ID : le msg_abc123 dont tu veux l'état.

Les messages d'une conversation remontent en collection filtrable et paginée, là où l'opération Get n'en rend qu'un.

• Chat : la conversation à lire.
• Limit et Offset : la taille de page et le nombre d'items sautés.
• Direction : inbound ou outbound.
• Since (Ms Timestamp) et Until (Ms Timestamp) : des timestamps Unix en millisecondes qui bornent la fenêtre.
• Sort : desc pour les plus récents, asc pour les plus anciens.

Tous les numéros rattachés à la clé d'API reviennent en un tableau, sans rien à régler sur le nœud. C'est l'appel d'inventaire dès qu'on émet depuis plusieurs lignes.

Les appels reçus sur l'un de tes numéros peuvent partir vers une autre ligne. L'opération ouvre la demande, elle n'active pas le renvoi d'elle-même.

• Number : le numéro source au format E.164.
• Forward To : le numéro américain de destination qui doit recevoir les appels, E.164 recommandé.

L'identité Name et Photo présentée par un numéro se règle ici, et seules les offres Dedicated y ont droit.

• Number : le numéro source au format E.164 dont la carte change.
• First Name et Last Name : l'identité vue par les destinataires.
• Avatar (Base64) : la photo de profil en JPEG ou PNG encodé en base64.
• Sharing Enabled : le partage de cette identité, actif ou non.

Validation et mise en forme d'un numéro, avec géocodage, une entrée à la fois. Il faut une offre Dedicated Enterprise.

• Number : le numéro à vérifier, en E.164, en notation nationale ou déjà formaté.

Même contrôle, mais en gros : jusqu'à 100 numéros voyagent dans une seule requête, ce qui évite de transformer un import en longue boucle.

• Numbers : la liste des numéros à vérifier, 100 au maximum par appel. Une offre Dedicated Enterprise est requise.

Un sondage iMessage natif est posté dans une conversation : les réponses arrivent en votes, pas en texte libre qu'il faut relire.

• Chat : la conversation, numéro, mail ou identifiant de groupe.
• Options : entre 2 et 10 réponses proposées.
• Title : la question affichée au-dessus des options.

La définition d'un sondage et le décompte agrégé des votes reviennent ensemble.

• Chat : la conversation où le sondage a été posté.
• Poll ID : l'identifiant porté par l'événement webhook poll.created ou poll.received.

Tapbacks et emoji passent par la même opération, qui retire aussi volontiers qu'elle ajoute.

• Message ID : un msg_abc123, ou un index relatif où -1 désigne le dernier message.
• Reaction : préfixée de + pour ajouter, de - pour retirer, avec un tapback classique comme love ou laugh, ou n'importe quel emoji.
• Chat : la conversation qui porte ce message.
• Direction : inbound ou outbound, utile seulement quand l'index est relatif.

L'indicateur de saisie s'affiche dans le fil et offre à un bot le temps de latence qu'un humain prendrait avant de répondre. iMessage uniquement.

• Chat : la conversation où l'indicateur apparaît, sous forme de numéro, de mail ou d'identifiant de groupe.

L'appel jumeau masque l'indicateur, et il compte surtout quand la branche qui l'a lancé se termine mal.

• Chat : le même identifiant de conversation que celui donné à l'opération de démarrage.

Tous les webhooks enregistrés sur le compte reviennent en un tableau, sans paramètre à remplir. C'est le point de départ de tout workflow qui entretient les abonnements au lieu de les créer à la main.

Un abonnement est enregistré : Blooio se met à poster ses événements vers l'URL fournie.

• Webhook URL : l'endpoint qui reçoit les événements, souvent l'URL de production d'un nœud Webhook n8n.
• Webhook Type : message, status ou all.
• Valid Until : un horodatage d'expiration en millisecondes, ou -1 pour aucune expiration.

Un abonnement précis est relu à partir de son identifiant, ce qui permet à un workflow de vérifier à quoi un endpoint est réellement configuré.

• Webhook ID : l'identifiant wh_abc123 de l'abonnement.

Un abonnement existant change sur place, sans toucher à l'identifiant que d'autres systèmes connaissent déjà.

• Webhook ID : le wh_abc123 modifié.
• Webhook Type : basculer le flux sur message, status ou all.
• Valid Until : repousser l'horodatage d'expiration en millisecondes, ou -1 pour le supprimer.
• Deprecate : true marque le webhook comme déprécié, false le réactive.

L'abonnement disparaît définitivement et les livraisons vers son URL s'arrêtent dès le retour de l'appel.

• Webhook ID : le wh_abc123 à supprimer.

Un nouveau secret de signature est généré pour l'abonnement, et il n'apparaît qu'une fois, dans la réponse de cet appel.

• Webhook ID : le wh_abc123 dont le secret est remplacé.

Les tentatives de livraison d'un abonnement se listent ici, et c'est là qu'on regarde quand un endpoint est soupçonné de perdre des événements.

• Webhook ID : l'abonnement dont tu lis les livraisons.
• Limit et Offset : taille de page et nombre d'entrées sautées.
• Status, Min Status et Max Status : filtrer sur un code HTTP exact ou sur une plage.
• Sort : desc pour les plus récentes, asc pour les plus anciennes.

Un événement déjà livré repart vers le même endpoint, ce qui évite de rejouer la conversation d'origine juste pour retrouver sa charge utile.

• Webhook ID : l'abonnement qui avait livré l'événement.
• Event ID : l'identifiant de l'événement à rejouer.