TeloDash

Documentation

Guide d'intégration
TeloDash

Analytics SaaS pour développeurs — tracker tes events en 5 minutes.

Introduction

Qu'est-ce que TeloDash ?

TeloDash est un SaaS analytics conçu pour les développeurs africains. Tu crées un compte, tu crées un projet, tu obtiens une API key et tu commences à tracker les événements de ton app en quelques minutes. Toutes tes données sont visibles en temps réel dans ton dashboard.

Comment ça marche ?

1. Crée un compte sur TeloDash. 2. Crée un projet et copie ton API key. 3. Installe le SDK et envoie tes premiers événements. 4. Visualise tout dans ton dashboard.

Démarrage rapide

1. Créer un compte

Rends-toi sur telodash.telopex.online et crée un compte gratuit. Aucune carte bancaire requise.

2. Créer un projet

Dans ton dashboard, clique sur + Nouveau projet. Donne-lui un nom et copie l'API key générée.

3. Installer le SDK

Installe le SDK officiel dans ton projet.

npm install telodash-js

4. Envoyer ton premier événement

Initialise le SDK avec ton API key et commence à tracker.

import { TeloDash } from 'telodash-js'

const td = new TeloDash('TON_API_KEY')

td.pageview('/home')
td.signup('user123')

Tracking d'événements

Méthodes disponibles

Le SDK propose des méthodes prêtes à l'emploi pour les événements les plus courants.

import { TeloDash } from 'telodash-js'

const td = new TeloDash('TON_API_KEY')

td.pageview('/home')
td.pageview('/dashboard', 'user123')
td.signup('user123')
td.login('user123')
td.click('bouton-acheter', '/pricing')

Événement custom

Pour tracker n'importe quel événement avec des données supplémentaires.

td.track('purchase', {
  userId: 'user123',
  page: '/checkout',
  data: {
    amount: 25000,
    currency: 'FCFA',
    plan: 'pro'
  }
})

Dans Next.js App Router

Utilise le SDK dans tes composants client.

'use client'

import { useEffect } from 'react'
import { TeloDash } from 'telodash-js'

const td = new TeloDash(process.env.NEXT_PUBLIC_TELODASH_KEY!)

export default function Page() {
  useEffect(() => {
    td.pageview('/dashboard')
  }, [])

  return <div>Mon dashboard</div>
}

TeloDashChart (bonus dev)

C'est quoi ?

TeloDashChart est un composant React réutilisable inclus dans le SDK. Il te permet d'afficher n'importe quelle donnée sous forme de graphique dans ton app. C'est un bonus pour les développeurs — pas lié aux plans d'abonnement.

Installation

TeloDashChart utilise recharts.

npm install telodash-js recharts

Mode Manuel — tes propres données

Passe n'importe quelle donnée et choisis le type de graphique.

import { TeloDashChart } from 'telodash-js/react'

<TeloDashChart
  data={[
    { mois: 'Jan', ventes: 5000 },
    { mois: 'Fev', ventes: 8000 },
  ]}
  xKey="mois"
  yKey="ventes"
  type="bar"
  title="Ventes mensuelles"
  color="#E2703A"
  height={300}
/>

// Multi-courbes
<TeloDashChart
  data={mesData}
  xKey="date"
  yKey={['visites', 'inscrits']}
  type="line"
  color={['#E2703A', '#14213D']}
  showLegend
/>

Mode Auto — données TeloDash

Affiche automatiquement tes données TeloDash.

<TeloDashChart
  apiKey="TON_API_KEY"
  projectId="TON_PROJECT_ID"
  metric="pageviews"
  type="area"
  title="Mes visites"
  color="#E2703A"
/>

Plans & Limites

Plans disponibles

TeloDash propose 4 plans adaptés à tous les besoins.

Gratuit   — 0 FCFA        — 1 projet   — 5 000 events/mois   — 7 jours
Starter   — 2 900/mois   — 3 projets  — 50 000 events/mois  — 3 mois
Pro       — 7 900/mois   — 10 projets — 500 000 events/mois — 1 an
Business  — 19 900/mois  — Illimité   — Illimité             — 3 ans

Que se passe-t-il quand la limite est atteinte ?

L'API /api/track retourne une erreur 429. Les events suivants ne sont pas enregistrés jusqu'à la fin du mois ou l'upgrade.

API Reference

POST /api/track

Endpoint public pour envoyer des événements. Pas d'authentification requise, juste ton API key.

fetch('https://telodash.telopex.online/api/track', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apiKey: 'TON_API_KEY',  // requis
    type: 'pageview',       // requis
    page: '/home',          // optionnel
    userId: 'user123',      // optionnel
    data: { key: 'value' }  // optionnel
  })
})

// Réponse succès
{ "ok": true, "id": "event_id" }

// Réponse erreur limite
{ "error": "Limite events atteinte" }

CORS

L'endpoint /api/track accepte les requêtes cross-origin depuis n'importe quel domaine.

Prêt à tracker ton app ?

Gratuit pour commencer — upgrade quand tu veux.