Aller au contenu principal

Messagerie des text channels

Cette page explique comment la messagerie des channels fonctionne pour les intégrations : comment découvrir les channels, la différence entre poster dans un channel et envoyer un message direct, le sous-ensemble markdown pris en charge par les messages, la règle de permission des participants, et la réponse renvoyée par chaque appel. Pour une orientation rapide et des exemples à copier-coller, commencez par l'introduction Channels.

Lister les channels​

L'endpoint list channels renvoie les channels que votre token peut voir, avec des filtres optionnels :

  • q — recherche insensible à la casse sur le nom du channel, la description, et le nom/e-mail des participants.
  • type — category, text, voice, inbox, classroom, meeting ou whatsapp.
  • kind — group ou dm.
  • participantId — channels qui incluent un utilisateur ou une équipe spécifique.
  • limit / offset — paginer les résultats (limit 1–200, défaut 100).

Chaque channel inclut son id, nom, type, kind, ids d'utilisateurs/équipes participants, et horodatages — assez pour découvrir le channelId vers lequel poster.

Envoyer un message de channel​

POST vers l'endpoint send-message du channel avec le channelId dans le chemin et un corps message (markdown, jusqu'à 10 000 caractères) :

curl -X POST "https://api.copera.ai/public/v1/chat/channel/{channelId}/send-message" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Deploy to production finished ✅" }'

Un envoi réussi renvoie 204 No Content.

Les messages prennent en charge un sous-ensemble de markdown — titres, gras/italique, listes ordonnées et non ordonnées, code inline et en bloc, citations, règles horizontales et liens.

note

Une intégration ne peut poster que dans les channels dont elle est participante. Ajoutez d'abord votre intégration au channel cible.

Envoyer un message direct​

POST vers l'endpoint direct-message avec le userId du destinataire et un message (jusqu'à 10 000 caractères). Copera crée ou réutilise le channel DM pour vous :

curl -X POST "https://api.copera.ai/public/v1/chat/direct-message/send-message" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "userId": "<member id>", "message": "Your report is ready." }'

Le DM est mis en file et la réponse (202 Accepted) renvoie le channelId résolu. Pour trouver le userId d'un destinataire, utilisez l'endpoint membres du Workspace avec une recherche q.

Authentification​

Les endpoints channel acceptent un Personal Access Token complet (cp_pat_) ou une Integration API Key (cp_key_) avec le scope access_channels. Voir Authentification pour les types de tokens.

Référence​