# Fiche connecteur Belco
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## Belco
URL : https://get-bruno.com/features/connectors/belco
Référence texte : https://get-bruno.com/features/connectors/belco/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Commerce
Description : Belco est un logiciel de service client pour les boutiques en ligne. Il couvre les conversations, les contacts, les notes, les tags et les échanges par canal.
Authentification : API key
Présentation : Belco est un logiciel de service client pour les boutiques en ligne. Il couvre les conversations, les contacts, les notes, les tags et les échanges par canal.
Usage : Ouvrir une conversation pour un client
Exemple de demande : Je veux ouvrir une conversation pour le client Atelier Martin avec le message "Votre commande est prête" sur le canal e-mail.
Résultat attendu : Une nouvelle conversation est créée avec le premier message, puis son identifiant peut servir à la consulter ou à y répondre.
À préciser : Le magasin Belco concerné ; Le canal visé ; Le message initial ; Un contact ou une adresse e-mail du destinataire
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/belco/actions/create-conversation ; https://pipedream.com/apps/belco/actions/list-contacts ; https://pipedream.com/apps/belco/actions/send-message ; https://pipedream.com/apps/belco/actions/list-shop-id-options
Usage : Consulter l’historique d’une conversation
Exemple de demande : Je veux retrouver la conversation liée au client Nora Dupont pour lire ses messages, ses notes et ses changements d’état.
Résultat attendu : La conversation et, si demandé, sa liste d’éléments sont renvoyées pour consultation.
À préciser : L’identifiant de la conversation ; Le besoin de détail : résumé ou historique complet
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/belco/actions/retrieve-conversation ; https://pipedream.com/apps/belco/actions/retrieve-conversation-items
Usage : Ajouter une note et fermer un dossier
Exemple de demande : Je veux ajouter la note "Rappel envoyé" sur la conversation 8421 puis la fermer.
Résultat attendu : Une note est ajoutée à la conversation, puis la conversation est fermée si l’identifiant est valable.
À préciser : L’identifiant de la conversation ; Le texte de la note ; La décision de clôture
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/belco/actions/add-note-to-conversation ; https://pipedream.com/apps/belco/actions/close-conversation ; https://pipedream.com/apps/belco/actions/retrieve-conversation
Limites propres au service : La création d’une conversation ou d’un message dépend d’un contact ou d’une adresse e-mail acceptée par le canal. La recherche de contacts peut servir à retrouver un identifiant avant une action d’envoi ou d’ouverture. Les déclencheurs listés décrivent des événements, mais ils ne servent pas d’entrée d’action dans Bruno. La récupération d’historique complet et la vue de synthèse sont deux opérations distinctes.
Vocabulaire français : Ajouter une note à une conversation — Ajoute une note à une conversation identifiée. (https://pipedream.com/apps/belco/actions/add-note-to-conversation)
Vocabulaire français : Ajouter des étiquettes à une conversation — Ajoute des étiquettes à une conversation. (https://pipedream.com/apps/belco/actions/add-tags-to-conversation)
Vocabulaire français : Fermer une conversation — Ferme une conversation identifiée. (https://pipedream.com/apps/belco/actions/close-conversation)
Vocabulaire français : Créer une conversation — Ouvre une nouvelle conversation dans une boutique sur e-mail, chat ou téléphone, avec un premier message. (https://pipedream.com/apps/belco/actions/create-conversation)
Vocabulaire français : Obtenir les détails d’un contact — Récupère les informations détaillées d’un contact Belco. (https://pipedream.com/apps/belco/actions/get-contact-details)
Vocabulaire français : Lister toutes les conversations — Récupère la liste des conversations Belco. (https://pipedream.com/apps/belco/actions/list-all-conversations)
Vocabulaire français : Lister les contacts — Récupère les contacts d’une boutique Belco, avec filtre possible par e-mail, téléphone ou type de contact. (https://pipedream.com/apps/belco/actions/list-contacts)
Vocabulaire français : Lister les options d’identifiant de boutique — Affiche les valeurs disponibles pour le champ Shop ID. (https://pipedream.com/apps/belco/actions/list-shop-id-options)
Vocabulaire français : Lister les utilisateurs — Récupère la liste des utilisateurs du compte Belco. (https://pipedream.com/apps/belco/actions/list-users)
Vocabulaire français : Rouvrir une conversation — Rouvre une conversation identifiée. (https://pipedream.com/apps/belco/actions/reopen-conversation)
Vocabulaire français : Répondre à une conversation — Ajoute une réponse à une conversation existante. (https://pipedream.com/apps/belco/actions/reply-to-conversation)
Vocabulaire français : Récupérer une conversation — Récupère une conversation identifiée. (https://pipedream.com/apps/belco/actions/retrieve-conversation)
Vocabulaire français : Récupérer les éléments d’une conversation — Récupère les messages, notes, affectations, étiquettes, appels et changements d’état d’une conversation. (https://pipedream.com/apps/belco/actions/retrieve-conversation-items)
Vocabulaire français : Envoyer un message — Envoie un message sur e-mail, chat ou téléphone et crée une nouvelle conversation qui le porte. (https://pipedream.com/apps/belco/actions/send-message)
Vocabulaire français : Conversation assignée (instantané) — Déclenche un événement à chaque affectation de conversation. (https://pipedream.com/apps/belco/triggers/conversation-assigned-instant)
Vocabulaire français : Conversation fermée (instantané) — Déclenche un événement à chaque fermeture de conversation. (https://pipedream.com/apps/belco/triggers/conversation-closed-instant)
Vocabulaire français : Conversation rouverte (instantané) — Déclenche un événement à chaque réouverture de conversation. (https://pipedream.com/apps/belco/triggers/conversation-reopened-instant)
Vocabulaire français : Conversation avec réponse (instantané) — Déclenche un événement à chaque nouvelle réponse sur une conversation. (https://pipedream.com/apps/belco/triggers/conversation-replied-instant)
Vocabulaire français : Nouvelle conversation — Déclenche un événement lors de la création d’une nouvelle conversation. (https://pipedream.com/apps/belco/triggers/new-conversation)
Vocabulaire français : Nouvelle conversation créée (instantané) — Déclenche un événement à chaque nouvelle conversation créée. (https://pipedream.com/apps/belco/triggers/new-conversation-created-instant)
Vocabulaire français : Nouvel événement de webhook (instantané) — Déclenche un événement à chaque nouvel événement de webhook. (https://pipedream.com/apps/belco/triggers/new-webhook-event)
Vocabulaire français : Note ajoutée (instantané) — Déclenche un événement à chaque nouvelle note ajoutée. (https://pipedream.com/apps/belco/triggers/note-added-instant)
- action : Add Note to Conversation — Add a note to a conversation specified by ID. See the documentation (https://pipedream.com/apps/belco/actions/add-note-to-conversation)
- action : Add Tags to Conversation — Add tags to a conversation. See the documentation (https://pipedream.com/apps/belco/actions/add-tags-to-conversation)
- action : Close Conversation — Close a conversation specified by ID. See the documentation (https://pipedream.com/apps/belco/actions/close-conversation)
- action : Create Conversation — Start a new Belco conversation in a shop on the email , chat or phone channel, sending Body as its first message. Use this to open a fresh thread, such as an outbound message or follow-up to a customer, or to log an inbound message or internal note. To add a message to a conversation that already exists, use Reply to Conversation instead. Address the recipient with either To (a contact ID from List Contacts ) or To Email (email channel only); To Email wins when both are set. Returns the created conversation; its _id can be passed to Retrieve Conversation , Reply to Conversation or Close Conversation . See the documentation (https://pipedream.com/apps/belco/actions/create-conversation)
- action : Get Contact Details — Get the details of a contact in Belco. See the documentation (https://pipedream.com/apps/belco/actions/get-contact-details)
- action : List All Conversations — Get a list of conversations from Belco. See the documentation (https://pipedream.com/apps/belco/actions/list-all-conversations)
- action : List Contacts — List the contacts of a Belco shop, optionally filtered by email address, phone number or contact type. Use this to look up a recipient's contact ID by email before calling Create Conversation , Send Message or Get Contact Details — or skip the lookup entirely by passing To Email to Create Conversation / Send Message . Use List Shop ID Options to find the shop ID. Paginate with Limit and Skip . See the documentation (https://pipedream.com/apps/belco/actions/list-contacts)
- action : List Shop ID Options — Retrieves available options for the Shop ID field. (https://pipedream.com/apps/belco/actions/list-shop-id-options)
- action : List Users — List all users in the Belco account. See the documentation (https://pipedream.com/apps/belco/actions/list-users)
- action : Reopen Conversation — Reopen a conversation specified by ID. See the documentation (https://pipedream.com/apps/belco/actions/reopen-conversation)
- action : Reply to Conversation — Reply to a conversation specified by ID. See the documentation (https://pipedream.com/apps/belco/actions/reply-to-conversation)
- action : Retrieve Conversation — Retrieve a conversation specified by ID. See the documentation (https://pipedream.com/apps/belco/actions/retrieve-conversation)
- action : Retrieve Conversation Items — Retrieve the list of items belonging to a conversation, such as messages, notes, assignments, tags, calls and status changes. Use this instead of Retrieve Conversation when you need the conversation's full message and event history rather than its top-level metadata. Returns a flat array in a single response with no pagination; each item carries a type field identifying which kind of event it is. See the documentation (https://pipedream.com/apps/belco/actions/retrieve-conversation-items)
- action : Send Message — Send a message in a Belco shop on the email , chat or phone channel, starting a new conversation that carries it. This action does not take a conversation ID. To add a message to a conversation that already exists, use Reply to Conversation instead. Address the recipient with either To (a contact ID from List Contacts ) or To Email (email channel only); To Email wins when both are set. Returns the resulting conversation; its _id can be passed to Retrieve Conversation or Reply to Conversation . See the documentation (https://pipedream.com/apps/belco/actions/send-message)
- trigger : Conversation Assigned (Instant) — Emit new event for each new conversation assigned event (https://pipedream.com/apps/belco/triggers/conversation-assigned-instant)
- trigger : Conversation Closed (Instant) — Emit new event for each new conversation closed event (https://pipedream.com/apps/belco/triggers/conversation-closed-instant)
- trigger : Conversation Reopened (Instant) — Emit new event for each new conversation reopened event (https://pipedream.com/apps/belco/triggers/conversation-reopened-instant)
- trigger : Conversation Replied (Instant) — Emit new event for each new conversation replied event (https://pipedream.com/apps/belco/triggers/conversation-replied-instant)
- trigger : New Conversation — Emit new conversation event when a new conversation is created. See the documentation (https://pipedream.com/apps/belco/triggers/new-conversation)
- trigger : New Conversation Created (Instant) — Emit new event for each new conversation created event (https://pipedream.com/apps/belco/triggers/new-conversation-created-instant)
- trigger : New Webhook Event (Instant) — Emit new event for each new webhook event (https://pipedream.com/apps/belco/triggers/new-webhook-event)
- trigger : Note Added (Instant) — Emit new event for each new note added event (https://pipedream.com/apps/belco/triggers/note-added-instant)