Aller au contenu
← Toutes les plateformes

Tutoriel TipTap

Vos rédacteurs dictent, l'éditeur écrit

Une extension TipTap et une route serveur : le texte arrive au curseur, sans les « euh », jamais reformulé. La clé secrète reste chez vous.

Ce qu'il vous faut≈ 10 min d'installation

  • TipTap 3
  • Un serveur capable de relayer une requête (Next.js, Express, Hono…)
  • Une offre Vokyt avec des minutes de dictée

Étape 1 sur 4 · Copier la clé secrète

vokyt.cc/tableau-de-bord

Pas à pas

  1. 01

    Récupérez la clé secrète

    sk_live_…

    Tableau de bord → Sites et intégration → votre site → clé secrète. Mettez-la dans une variable d'environnement du serveur (VOKYT_SECRET_KEY). Elle ne doit jamais arriver dans le navigateur.

    env
    VOKYT_SECRET_KEY=sk_live_…
  2. 02

    Installez l'extension

    @vokyt/tiptap

    Le paquet sera publié sur npm ; écrivez-nous à bonjour@vokyt.cc pour y accéder dès maintenant.

    sh
    pnpm add @vokyt/tiptap
  3. 03

    Ajoutez la route de relais

    relayDictation

    Le navigateur envoie l'audio à votre serveur, qui le relaie à Vokyt avec la clé secrète. Vérifiez ici que l'utilisateur est connecté.

    ts
    import { relayDictation } from "@vokyt/tiptap/server";
    
    export async function POST(req: Request) {
      // Vérifiez ici que l'utilisateur est connecté
      return relayDictation(req, { secretKey: process.env.VOKYT_SECRET_KEY! });
    }
  4. 04

    Ajoutez l'extension à l'éditeur

    Dictation.configure

    Ctrl/Cmd + Maj + D lance et arrête la dictée. Commandes : startDictation(), stopDictation(), toggleDictation(), cancelDictation().

    ts
    import { Dictation } from "@vokyt/tiptap";
    
    new Editor({
      extensions: [
        StarterKit,
        Dictation.configure({
          endpoint: "/api/vokyt/dictation",
          language: "fr",
          onStateChange: (state) => console.log(state), // idle | recording | transcribing
        }),
      ],
    });

Questions fréquentes

Combien de minutes de dictée ?

Celles de votre offre Vokyt (15 min avec Gratuit, 2 h avec Blogueur, 5 h avec Créateur, 15 h avec Pro par mois), partagées avec le tableau de bord, WordPress et les brouillons vocaux. 10 minutes au plus par prise.

L'audio est-il conservé ?

Non : il est transcrit puis oublié. Seuls la durée et le nombre de caractères sont gardés pour décompter les minutes.

Autres plateformes

Prêt à faire entendre votre voix ?

Créez votre compte, enregistrez un premier vocal et suivez les étapes : c'est gratuit pour commencer.