add explanations for tutors about availabilities + meeting link (info about creating Cal.com link, creating meeting type, adding webhook)
Activité
added To do label
assigned to @bridubois
changed milestone to %0.1: Basic test & chat ready
What is currently missing at https://forge.uclouvain.be/sbibauw/languagelab/-/blob/main/docs/cal.com.md ?
added waiting label
assigned to @LucieBocken and unassigned @bridubois
Bonjour @LucieBocken
- Pouvez-vous dire si le système de webhook a fonctionné pour la planification d'une session ? Sinon, savez-vous ce qui a échoué (probablement pas, mais au cas où)?
- Pouvez-vous dire si les instructions sur https://forge.uclouvain.be/sbibauw/languagelab/-/blob/main/docs/cal.com.md étaient suffisamment claires ? Est-ce que vous pourriez reformuler ou ajouter ce qui manquerait (ou à défaut, indiquer où ce n'est pas clair) ?
@bridubois apart from any adaptation based on what @LucieBocken will say, the point here was mostly to include the instructions from
cal.com.mdin the page/tutor/timeslotsremoved waiting label
Je copie-colle la réponse de @LucieBocken:
Pour la première étape, je pense que ça fonctionne mais je ne sais pas par quel moyen je pourrais m'en assurer. En tout cas, si j'essaie de planifier une session avec moi-même, ça a l'air de marcher même si les horaires proposés (17:00-21:00) (voir image 1) ne sont pas les horaires que j'ai encodés dans la partie "sélectionnez vos disponibilités" (voir image 2). Peut-être que je peux réserver une session chez vous?
=> En fait, je comprends que la page de disponibilités sur LanguageLab confond un peu l'utilisateur. Son objectif est seulement d'indiquer "grosso modo" quand on pense être disponible. Par contre, ce qui compte vraiment, ce sont les plages sélectionnées sur Cal.com...
- @bridubois: Let's discuss solutions for this. Minimal: explanation that timeslots is only a first, informative step. Ideal: display Cal.com availabilities of each tutor via embed or other display? Or: abandon Cal.com (because of problems for webhooks to work well) but then how to select slots? (Everyone @LucieBocken @VictoriaDemierbe is welcome to chime in on this: if you see a better solution to find matching moments without using Cal.com, let me know.)
Pour la deuxième étape sur les instructions, j'ai rencontré un souci à l'étape "Créer un webhook (onglet "Webhooks") avec l'URL https://languagelab.sipr.ucl.ac.be/api/v1/webhooks/sessions comme Lien de l'abonné. Tous les "Déclencheurs d'évènement" (triggers) peuvent être laissés tels quel. "Secret" peut être laissé vide. [Créer un webhook]" parce que je ne voyais pas d'emblée l'onglet webhooks sur la plateforme mais cette difficulté tient surtout au fait que je ne suis absolument pas familière avec la plateforme CAL.com.
D'une façon générale, j'ai trouvé ça suffisamment clair même si des illustrations intermédiaires supplémentaires des différentes étapes pourraient constituer une bonne aide si la personne ne trouve pas d'emblée le chemin à suivre.=>
-
Add instructions on
/tutor/timeslots: very short instructions + link to a specific page that can appear on click (modal, popup, or new tab): @bridubois - Page with all instructions, including screenshots @bridubois
- Add screenshot to locate "Webhooks" on Cal.com (French display language) @LucieBocken
@LucieBocken , pouvez-vous donc juste faire le screenshot manquant (ou les screenshot manquants) pour guider les futurs utilisateurs ? Si vous avez eu du mal à trouver certaines choses, ce sera surement le cas des suivants (personne n'aura l'habitude de Cal.com ;-)).
Modifié par Serge Bibauwchanged milestone to %0.2: Essential functions ready & corrective feedback
mentioned in issue #113 (closed)
added UX label
changed milestone to %0.2: Essential functions ready & corrective feedback
