---
Title: 🚍  Kokyo
---

Kokyo est un chatbot qui te permet d'obtenir rapidement des informations
sur les transports en commun dans toute la Suisse.
Pour le moment, il fonctionne uniquement sur [Telegram](https://telegram.org/).

Techniquement, les données sont récupérées depuis la [plateforme open data pour la mobilité en Suisse](https://opentransportdata.swiss/fr)
et leur API _Open Journey Planner_ (standard européen). Le serveur, développé avec Deno (Typescript), est hébergé sur un VPS chez Infomaniak.

C'est un service gratuit que je développe sur mon temps libre et avec mes propres moyens (notamment pour l'hébergement).

# Comment l'utiliser ?

1. Sur Telegram, chercher `Kokyo` ou ouvrez ce lien: https://t.me/KokyoBot
2. Initier une conversation en cliquant sur *Démarrer*. Le message d'aide s'affiche.
3. Envoyer le nom d'un arrêt ou votre position GPS. Kokyo vous retourne la liste des arrêts correspondants.
4. Sélectionner l'arrêt que vous voulez. Kokyo vous retourne les prochains départs pour cet arrêt.

Afin d'être plus rapide la prochaine fois, vous avez la possibilité de mettre en favoris
des arrêts. En envoyant `/favoris` (en passant par le menu ou en le tapant au clavier),
Kokyo vous retourne la liste de vos favoris.

# FAQ

## Pourquoi un chatbot ?

En tant qu'usager des transports publics en Suisse, notamment à Genève, je suis déçu
par l'application mobile officielle qui est proposée.
Il y a beaucoup trop d'informations et il faut faire plusieurs actions avant d'avoir
ce qu'on veut, ce qui génère chez moi de la frustration quand j'essaye d'attraper un
bus ou un train rapidement.

Un chatbot permet d'avoir un service minimaliste sans nécessiter l'installation
d'une app supplémentaire sur son téléphone.
Il suffit d'ouvrir son app de messagerie et demander un arrêt pour avoir rapidement
une réponse, sans avoir à naviguer.

## Pourquoi uniquement sur Telegram ?

Telegram est particulièrement pratique pour développer des chatbots avec peu d'effort.
Tout est [bien documenté](https://core.telegram.org/bots/api) et facile d'utilisation
d'un point de vue développeur.

De plus, Telegram propose des fonctionnalités intéressantes: gestion de la localisation,
possibilité de proposer des racourcis,...

## Pourquoi pas Whatsapp ?

Whatsapp est un service plus fermé que Telegram et ne permet pas de développer
des chatbots ou du moins, pas sans vendre son âme à Meta, ce que je refuse de faire.

Si vous souhaitez néanmoins contribuer à Kokyo pour qu'il fonctionne sur Whatsapp,
c'est bienvenue :-)

## Comment aider ?

Si vous aimez Kokyo et que vous voulez participer à son développement, vous pouvez:

- utiliser le service et me faire des retours sur [Mastodon](https://tooting.ch/@5ika) ou [par mail](mailto:tim@5ika.ch)
    - un problème dans le fonctionnement ?
    - une suggestion d'amélioration ?
    - une faute d'orthographe ?
- récupérer le [code source sur GitHub](https://github.com/5ika/Kokyo) et proposer des ajouts / améliorations