# Fiche connecteur Element
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.

## Element
URL : https://get-bruno.com/features/connectors/element
Référence texte : https://get-bruno.com/features/connectors/element/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Communication
Description : Element sert à gérer la messagerie et les espaces Matrix, avec des actions sur les salons, les invitations et la modération. Le service expose des opérations pour retrouver un salon, y publier un message ou agir sur ses membres.
Authentification : API key
Présentation : Element sert à gérer la messagerie et les espaces Matrix, avec des actions sur les salons, les invitations et la modération. Le service expose des opérations pour retrouver un salon, y publier un message ou agir sur ses membres.
Usage : Créer un salon de travail pour une équipe
Exemple de demande : Je veux créer un salon nommé « Projet Atlas » avec une alias lisible et y inviter immédiatement « @lea:matrix.org ».
Résultat attendu : Un nouveau salon est créé, avec un identifiant de salon renvoyé pour les actions suivantes, et l'invitation peut être préparée dans la même opération.
À préciser : Le nom du salon ; L'alias souhaitée si elle doit être définie ; L'identifiant Matrix de la personne à inviter
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/element/actions/create-room ; https://pipedream.com/apps/element/actions/invite-user
Usage : Envoyer un message dans un salon déjà joint
Exemple de demande : Je veux envoyer dans le salon « !OGEhHVWSdvArJzumhm:matrix.org » le message « La réunion commence à 14 h 30 ».
Résultat attendu : Un message texte est envoyé dans le salon indiqué et un identifiant d'événement est renvoyé.
À préciser : L'identifiant du salon ; Le texte du message
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/element/actions/list-rooms ; https://pipedream.com/apps/element/actions/send-message
Usage : Retrouver le bon salon à partir d'une alias puis modérer un membre
Exemple de demande : Je veux vérifier que l'alias « #engineering:matrix.org » pointe toujours vers le bon salon, puis expulser « @sam:matrix.org » de ce salon.
Résultat attendu : L'alias est résolue en identifiant de salon, puis le membre peut être expulsé si le compte connecté a les droits suffisants.
À préciser : L'alias du salon ou son identifiant ; L'identifiant Matrix du membre ; Le motif éventuel de la modération
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/element/actions/resolve-room-alias ; https://pipedream.com/apps/element/actions/kick-user
Limites propres au service : Les actions de salon exigent un identifiant de salon, pas une alias, sauf pour la résolution initiale. Le compte connecté doit déjà avoir rejoint le salon pour envoyer un message, inviter, expulser ou bannir. La liste des salons ne renvoie que des identifiants de salons, sans nom ni sujet. Les expulsions et bannissements dépendent du niveau de pouvoir dans le salon.
Vocabulaire français : Bannir un utilisateur — Bannit un utilisateur d'un salon et l'empêche de revenir tant que le bannissement n'est pas levé. (https://pipedream.com/apps/element/actions/ban-user)
Vocabulaire français : Créer un salon — Crée un nouveau salon Matrix et peut inviter des personnes dès la création. (https://pipedream.com/apps/element/actions/create-room)
Vocabulaire français : Inviter un utilisateur — Envoie une invitation à un utilisateur déjà autorisée par les droits du compte connecté. (https://pipedream.com/apps/element/actions/invite-user)
Vocabulaire français : Expulser un utilisateur — Retire un utilisateur d'un salon sans lui interdire de revenir plus tard. (https://pipedream.com/apps/element/actions/kick-user)
Vocabulaire français : Quitter un salon — Fait quitter un salon au compte connecté ou refuse une invitation en attente. (https://pipedream.com/apps/element/actions/leave-room)
Vocabulaire français : Lister les salons — Retourne les identifiants des salons déjà rejoints par le compte connecté. (https://pipedream.com/apps/element/actions/list-rooms)
Vocabulaire français : Résoudre une alias de salon — Transforme une alias lisible en identifiant de salon Matrix et renvoie les serveurs associés. (https://pipedream.com/apps/element/actions/resolve-room-alias)
Vocabulaire français : Envoyer un message — Publie un message texte dans un salon déjà rejoint par le compte connecté. (https://pipedream.com/apps/element/actions/send-message)
Vocabulaire français : Lever un bannissement — Autorise à nouveau un utilisateur à être invité ou à rejoindre le salon selon ses règles. (https://pipedream.com/apps/element/actions/unban-user)
- action : Ban User — Ban a user from a room, also kicking them if they are currently joined. A banned user cannot rejoin or be invited back until the ban is lifted with Unban User — use Kick User instead to remove someone without blocking their return. The connected account must be in the room with a power level high enough to ban, otherwise the API returns M_FORBIDDEN . Use List Rooms to find the room ID. See the documentation (https://pipedream.com/apps/element/actions/ban-user)
- action : Create Room — Create a new room, optionally inviting other users to it right away. Returns the new room's ID, which can be passed into Send Message or Invite User . Set Room Alias Name to give the room a memorable local alias (e.g. thepub becomes #thepub:matrix.org on matrix.org). If you omit Preset , Visibility also picks join rules — public creates an openly-joinable room. See the documentation (https://pipedream.com/apps/element/actions/create-room)
- action : Invite User — Invite a user to an existing room. The connected account must already be joined to the room and have permission to invite. Optionally include a Reason , which is stored on the membership event. See the documentation (https://pipedream.com/apps/element/actions/invite-user)
- action : Kick User — Remove a user from a room without banning them. A kicked user can be invited back with Invite User , and can rejoin on their own if the room's join rules allow it — use Ban User instead to also block their return. The connected account must be in the room with a power level high enough to kick, otherwise the API returns M_FORBIDDEN ; the same error is returned if the target user is not currently in the room. Use List Rooms to find the room ID. See the documentation (https://pipedream.com/apps/element/actions/kick-user)
- action : Leave Room — Leave a room the connected account has joined, or reject a pending invite to it. After leaving, the account stops receiving new events in the room; rejoining an invite-only room requires a fresh invite, so treat this as hard to undo. Use List Rooms to find the room ID. See the documentation (https://pipedream.com/apps/element/actions/leave-room)
- action : List Rooms — List the Matrix rooms the connected account has joined. The Matrix API only returns room IDs from this endpoint (no name or topic) — pass a returned ID directly into Send Message or Invite User . Because the IDs are opaque, prefer Resolve Room Alias when you know the room by an alias such as #engineering:matrix.org . See the documentation (https://pipedream.com/apps/element/actions/list-rooms)
- action : Resolve Room Alias — Look up the room ID that a human-readable room alias points to, e.g. #engineering:matrix.org . Every other action in this app takes a room ID ( !OGEhHVWSdvArJzumhm:matrix.org ) and rejects aliases, so use this first whenever you only know the alias. Aliases can be re-pointed to a different room over time, so always trust the returned room_id rather than assuming an alias still maps to the room you expect. Returns the room ID and the servers that know the alias. See the documentation (https://pipedream.com/apps/element/actions/resolve-room-alias)
- action : Send Message — Send a text message to a room. The room must be one the connected account has already joined, and must be identified by room ID rather than alias — use List Rooms to find it. Returns the event_id of the sent message. See the documentation (https://pipedream.com/apps/element/actions/send-message)
- action : Unban User — Lift a ban on a user in a room, reversing Ban User . Unbanning does not put the user back in the room — it only allows them to be invited again, and to rejoin if the room's join rules would otherwise let them. The connected account must have a power level high enough to unban, otherwise the API returns M_FORBIDDEN . Use List Rooms to find the room ID. See the documentation (https://pipedream.com/apps/element/actions/unban-user)