1---
 2Title: 🚍  Kokyo
 3---
 4
 5Kokyo est un chatbot qui te permet d'obtenir rapidement des informations
 6sur les transports en commun dans toute la Suisse.
 7Pour le moment, il fonctionne uniquement sur [Telegram](https://telegram.org/).
 8
 9Techniquement, les données sont récupérées depuis la [plateforme open data pour la mobilité en Suisse](https://opentransportdata.swiss/fr)
10et leur API _Open Journey Planner_ (standard européen). Le serveur, développé avec Deno (Typescript), est hébergé sur un VPS chez Infomaniak.
11
12C'est un service gratuit que je développe sur mon temps libre et avec mes propres moyens (notamment pour l'hébergement).
13
14# Comment l'utiliser ?
15
161. Sur Telegram, chercher `Kokyo` ou ouvrez ce lien: https://t.me/KokyoBot
172. Initier une conversation en cliquant sur *Démarrer*. Le message d'aide s'affiche.
183. Envoyer le nom d'un arrêt ou votre position GPS. Kokyo vous retourne la liste des arrêts correspondants.
194. Sélectionner l'arrêt que vous voulez. Kokyo vous retourne les prochains départs pour cet arrêt.
20
21Afin d'être plus rapide la prochaine fois, vous avez la possibilité de mettre en favoris
22des arrêts. En envoyant `/favoris` (en passant par le menu ou en le tapant au clavier),
23Kokyo vous retourne la liste de vos favoris.
24
25# FAQ
26
27## Pourquoi un chatbot ?
28
29En tant qu'usager des transports publics en Suisse, notamment à Genève, je suis déçu
30par l'application mobile officielle qui est proposée.
31Il y a beaucoup trop d'informations et il faut faire plusieurs actions avant d'avoir
32ce qu'on veut, ce qui génère chez moi de la frustration quand j'essaye d'attraper un
33bus ou un train rapidement.
34
35Un chatbot permet d'avoir un service minimaliste sans nécessiter l'installation
36d'une app supplémentaire sur son téléphone.
37Il suffit d'ouvrir son app de messagerie et demander un arrêt pour avoir rapidement
38une réponse, sans avoir à naviguer.
39
40## Pourquoi uniquement sur Telegram ?
41
42Telegram est particulièrement pratique pour développer des chatbots avec peu d'effort.
43Tout est [bien documenté](https://core.telegram.org/bots/api) et facile d'utilisation
44d'un point de vue développeur.
45
46De plus, Telegram propose des fonctionnalités intéressantes: gestion de la localisation,
47possibilité de proposer des racourcis,...
48
49## Pourquoi pas Whatsapp ?
50
51Whatsapp est un service plus fermé que Telegram et ne permet pas de développer
52des chatbots ou du moins, pas sans vendre son âme à Meta, ce que je refuse de faire.
53
54Si vous souhaitez néanmoins contribuer à Kokyo pour qu'il fonctionne sur Whatsapp,
55c'est bienvenue :-)
56
57## Comment aider ?
58
59Si vous aimez Kokyo et que vous voulez participer à son développement, vous pouvez:
60
61- utiliser le service et me faire des retours sur [Mastodon](https://tooting.ch/@5ika) ou [par mail](mailto:tim@5ika.ch)
62    - un problème dans le fonctionnement ?
63    - une suggestion d'amélioration ?
64    - une faute d'orthographe ?
65- récupérer le [code source sur GitHub](https://github.com/5ika/Kokyo) et proposer des ajouts / améliorations