Via CEP

Vue d'ensemble

Le Composant d’intégration ViaCEP (identifié dans l’interface par le nom technique descriptif via_cep) est un nœud d’action axé sur l’enrichissement des données (enrichissement des données) et la consultation d’API externes d’utilité publique. Sa fonction principale est d’automatiser la localisation des adresses postales brésiliennes dans le flux de service. Il capture un code postal (CEP) fourni par l’utilisateur et effectue, nativement et en arrière-plan, une requête HTTP de type GET aux serveurs du service ViaCEP, en renvoyant la structure complète de la rue, du quartier, de la ville et de l’État.

Paramètres de configuration

La configuration du bloc gère la chaîne d’entrée pour la requête au webservice à travers un seul critère obligatoire :

• CEP (* Champ obligatoire) : Champ de saisie texte destiné à recevoir la numérotation du code postal qui sera consulté. Il accepte la saisie de valeurs statiques ou l’injection de variables dynamiques du flux qui stockent la réponse saisie par le client (ex : {{response}} ou {{cliente.cep_bruto}}).

Constructeur visuel

L’interface du constructeur a été conçue selon un modèle épuré et direct, afin d’abstraire les configurations complexes d’en-têtes ou de jetons de requête :

• Panneau de saisie directe : Affiche une interface épurée composée exclusivement du champ de saisie du CEP. L’indicateur astérisque (*) agit comme un verrou de sécurité visuel, empêchant l’administrateur d’enregistrer le composant sans définir un paramètre de recherche. S’agissant d’un bus de requête publique natif, le nœud dispense de sélecteurs d’identifiants, d’authentifications API ou de téléversements de médias.

• Mise à disposition du payload de sortie : Sur la carte visuelle d’automatisation, le bloc présente des connecteurs traditionnels d’entrée et de sortie continue. Une fois raccordé à l’arborescence, le système expose automatiquement l’objet de données résultant de ViaCEP afin que les nœuds voisins puissent lire et consommer les propriétés de l’adresse localisée.

Opérateurs spéciaux

Les propriétés logiques de ce composant gèrent le nettoyage des données en temps réel, le traitement des erreurs de requête et le mappage des payloads JSON :

• Traitement automatique du masque (sanitization) : Le moteur interne du composant nettoie automatiquement la chaîne saisie dans le champ CEP avant de déclencher l’endpoint. Il applique des expressions régulières pour supprimer les caractères spéciaux, les tirets (-) ou les espaces vides, garantissant l’envoi correct du format standard à 8 chiffres exigé par ViaCEP.

• Mappage de la structure de réponse (objet JSON) : Après avoir traité avec succès l’appel synchrone, le moteur de la plateforme injecte les propriétés renvoyées directement dans le champ de données du contact ($data). Le payload renvoyé suit le standard du service et inclut les sous-variables suivantes prêtes à l’emploi :

  • via_cep.logradouro: Nom de la rue, avenue, place, etc.

  • via_cep.bairro: Quartier ou district correspondant.

  • via_cep.localidade: Nom de la commune/de la ville.

  • via_cep.uf: Code de l’État (Unité de la Fédération).

  • via_cep.complemento: Informations complémentaires sur le lotissement ou la région (le cas échéant).

• Gestion du chemin d’échec (CEP inexistant) : Si le webservice renvoie que le CEP consulté est invalide ou inexistant (retour { "erro": true }), le composant empêche l’enregistrement de données vides et permet au flux d’emprunter des chemins alternatifs de correction.

Exemples pratiques

Le tableau ci-dessous présente des scénarios d’utilisation de ce composant pour optimiser les inscriptions et les livraisons dans le parcours du bot :

CEP indiqué dans le constructeur	Réponse du serveur ViaCEP	Propriétés injectées dans le flux	Cas d'utilisation pratique
70040-010	Succès de la requête.	via_cep.logradouro = "SBN Quadra 1 Bloc A" via_cep.localidade = "Brasília" via_cep.uf = "DF"	Le client saisit le CEP avec un tiret dans le chat. Le bloc traite la chaîne, recherche les données et renseigne automatiquement l’adresse à des fins de facturation.
{{resposta_cep}}	Succès de la requête.	via_cep.logradouro = "Praça da Sé" via_cep.bairro = "Sé" via_cep.localidade = "São Paulo" via_cep.uf = "SP"	Dans un flux de livraison e-commerce, le bot demande le CEP du client. Ce composant traite la réponse et affiche ensuite un message de confirmation : "Vous habitez dans la {{via_cep.logradouro}}, dans le quartier {{via_cep.bairro}} à {{via_cep.localidade}}/{{via_cep.uf}}? Oui ou non ?"
00000000	Réponse d’erreur (CEP non trouvé).	Aucune propriété d’adresse n’est injectée.	L’utilisateur saisit un numéro invalide dans le chat. Le système identifie l’échec dans le retour du bloc et l’oriente vers un nœud de question lui demandant de ressaisir le code postal.