Entrée et sortie

Chez Hablla, toute entrée et sortie d'un composant se fait au format JSON. Cela signifie que chaque action dans le flux d'automatisation reçoit des informations (entrée), traite ces données et renvoie un résultat (sortie). Comprenons mieux comment cela fonctionne et comment vous pouvez utiliser ces informations au quotidien.

---

🏗 Flux de données dans Hablla

1️⃣ Entrée → Le composant reçoit un ensemble de données en JSON, provenant d'autres étapes du flux. 2️⃣ Traitement → Le composant manipule les données et effectue des requêtes internes ou externes. 3️⃣ Sortie → Le composant renvoie un JSON avec les informations traitées, y compris le statut, les détails de la requête et les résultats obtenus.

📌 Exemple réel dans Hablla : Imaginez qu'un composant reçoive les données d'un contact WhatsApp et doive créer une fiche d'assistance dans le système.

---

📥 Entrée de données

L'entrée contient toutes les informations disponibles pour le composant. Ces informations proviennent des composants précédents du flux.

Exemple d'entrée (JSON) :

{
  "whatsapp": {
    "name": "Marcus Barboza",
    "phone_number": "5517997275046"
  },
  "person": {
    "name": "Marcus Barboza",
    "customer_status": "lead",
    "id": "675c7667dc2708736e804575"
  },
  "service": {
    "type": "whatsapp",
    "status": "in_bot",
    "id": "67c7503f15788872a1f61328"
  },
  "content": {
    "body": "Hablla, boa tarde!"
  }
}

Les données dans Hablla sont générées à partir des interactions des utilisateurs, capturées depuis des systèmes externes ou ajoutées par des composants précédents du flux d'automatisation. Les automatisations dans Hablla peuvent être déclenchées par des événements provenant de composants réceptifs comme WhatsApp, Instagram, Messenger, Telegram, Email, Téléphone, ainsi que des intégrations via Webhooks, CRON et Déclencheur.

Ces événements (trigger) peuvent être activés par différents types d'actions au sein de la plateforme, tels que : ✅ Interactions avec des personnes → Leads, clients ou utilisateurs effectuant des actions dans le système. ✅ Organisations → Mises à jour des entreprises enregistrées. ✅ Fiches (Cards) → Mouvements au sein des tableaux et pipelines. ✅ Bot et Chat → Messages envoyés ou reçus par IA ou opérateurs humains. ✅ Appels téléphoniques et e-mails → Enregistrements et mises à jour des communications. ✅ Champs personnalisés (Custom Fields) → Modifications de données spécifiques dans le CRM. ✅ Événements de session → Connexion, déconnexion, session expirée, statut en ligne/hors ligne. ✅ Services et transferts → Affectations de prises en charge et déplacements entre services. ✅ Tags et utilisateurs → Actions liées à la segmentation et aux permissions des utilisateurs. ✅ Tâches et dictionnaire de données → Mises à jour des tâches ou des informations structurées. ✅ Conversions et changements de statut → Modifications des étapes de l'entonnoir de vente et de support.

Chaque fois que l'un de ces événements est activé dans Hablla, il déclenche un trigger qui reçoit les données de l'événement et exécute des actions configurées, telles que : Créer, Mettre à jour, Supprimer, Fusionner, entre autres. 🚀

---

⚙ Traitement des données

Entre la entrée et la sortie, le composant manipule les données reçues. Il peut : ✅ Consulter une base de données → Rechercher des informations sur des clients, des commandes, etc. ✅ Faire un appel à une API externe → Par exemple intégrer un ERP ou un autre système avec API ouverte. ✅ Appliquer des règles d'automatisation → Créer, mettre à jour ou supprimer des enregistrements dans Hablla selon les règles du flux.

---

📤 Sortie de données

La sortie contient le résultat de l'opération du composant. Elle suit toujours le même format et inclut :

1️⃣ value → Résultat de l'opération (exemple : succès ou erreur). 2️⃣ headers → En-têtes de la requête (utile pour le débogage et la sécurité). 3️⃣ config → Configuration de la requête, comme l'URL et le délai de réponse. 4️⃣ request → Chemin de l'appel effectué par le composant. 5️⃣ data → Le résultat final de l'opération.

Exemple de sortie (JSON) :

{
  "status": "fulfilled",
  "value": {
    "status": 200,
    "statusText": "OK",
    "headers": {
      "content-type": "application/json; charset=utf-8",
      "date": "Tue, 04 Mar 2025 19:10:56 GMT"
    },
    "config": {
      "method": "GET",
      "url": "https://api.hablla.com/v3/workspaces/643d802021b6aa9234eb9797/cards"
    },
    "request": {
      "method": "GET",
      "path": "/v3/workspaces/643d802021b6aa9234eb9797/cards?person=675c7667dc2708736e804575"
    },
    "data": {
      "results": [],
      "count": 0,
      "totalItems": 0
    }
  }
}

🔹 Que signifient ces données ? ✅ status : Indique si l'opération a réussi (fulfilled) ou s'il y a eu une erreur. ✅ value.status : Le code de réponse HTTP (200 signifie succès, 400 erreur de requête, etc.). ✅ config.url : L'URL utilisée dans la requête. ✅ request.path : Le chemin exact de l'API appelée. ✅ data : Le résultat de la requête (dans ce cas, aucune fiche trouvée pour cette personne).

---

🛠 Comment utiliser ces données dans le flux

💡 Vous pouvez accéder à n'importe quelle valeur de la entrée ou de la sortie du composant dans le flux en utilisant la syntaxe :

{{$data?.codigoDoComponente?.caminhoVariavel}}

📌 Il existe des exemples dans Utilisation des variables

---

🚀 Conclusion

🔹 L'entrée contient les données disponibles avant l'exécution du composant. 🔹 Le composant traite ces données, effectue des requêtes et applique des règles d'automatisation. 🔹 La sortie montre le résultat de l'opération, permettant au flux de continuer automatiquement.

💡 Astuce : Analysez toujours la entrée et la sortie pour comprendre comment les données circulent dans l'automatisation. Cela facilite l'identification des erreurs et la configuration correcte de vos règles ! 🚀