Suivre un Lead

Endpoint

POST https://track.taap.it/api/events/lead

Authentification

Côté serveur (Recommandé)
Côté client

Utilisez votre clé API secrète :

Authorization: Bearer taapit_sk_xxxxxxxxxxxx

Utilisez votre clé publique :

X-Publishable-Key: taapit_pk_xxxxxxxxxxxx

Corps de la requête

Champ	Type	Requis	Description
`trackingId`	string	✓	Le `ta_tid` du cookie ou paramètre URL
`customer`	object	✓	Informations client
`customer.externalId`	string	✓	Votre ID utilisateur/client interne
`customer.email`	string		Adresse email du client
`customer.firstname`	string		Prénom du client
`customer.lastname`	string		Nom du client
`customer.phoneNumber`	string		Numéro de téléphone du client
`customer.avatarUrl`	string		URL de l’avatar du client
`metadata`	object		Données personnalisées (paires clé-valeur)

Exemples

cURL
SDK Node.js
Hook React
JavaScript

curl -X POST https://track.taap.it/api/events/lead \
  -H "Authorization: Bearer taapit_sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "trackingId": "rLnWe1uz9t282v7g",
    "customer": {
      "externalId": "user_123",
      "email": "[email protected]",
      "firstname": "John",
      "lastname": "Doe"
    },
    "metadata": {
      "source": "signup-form"
    }
  }'

import { Taapit } from 'taapit-sdk';

const taapit = new Taapit({
  apiKey: process.env.TAAPIT_API_KEY,
});

await taapit.track.lead({
  trackingId: 'rLnWe1uz9t282v7g',
  customer: {
    externalId: 'user_123',
    email: '[email protected]',
    firstname: 'John',
    lastname: 'Doe',
  },
  metadata: {
    source: 'signup-form',
  },
});

import { useTaapitAnalytics } from 'taapit-sdk/react';

function SignUpForm() {
  const { trackLead } = useTaapitAnalytics();

  const handleSignUp = async (user) => {
    trackLead({
      customer: {
        externalId: user.id,
        email: user.email,
        firstname: user.firstName,
        lastname: user.lastName,
      },
      metadata: {
        source: 'signup-form',
      },
    });
  };
}

<script src="https://taap.it/api/sdk" data-publishable-key="taapit_pk_xxx"></script>

<script>
  taapit.trackLead({
    customer: {
      externalId: 'user_123',
      email: '[email protected]',
      firstname: 'John',
      lastname: 'Doe',
    },
    metadata: {
      source: 'signup-form',
    },
  });
</script>

Réponse

200 OK
400 Bad Request
401 Unauthorized
404 Not Found

{
  "ok": true
}

{
  "error": "Missing customer.externalId"
}

{
  "error": "Invalid API key"
}

{
  "error": "Click not found for this trackingId"
}

Codes d’erreur

Code HTTP	Erreur	Description
400	`Invalid payload`	Validation du corps de requête échouée
400	`Missing customer.externalId`	Champ requis non fourni
401	`Invalid API key`	Clé API invalide ou révoquée
401	`Hostname not in allowed list`	Origine non autorisée (côté client)
403	`This click does not belong to your workspace`	trackingId appartient à un autre workspace
404	`Click not found for this trackingId`	trackingId n’existe pas ou a expiré

Commencer

Conversions

Référence API

Endpoint

Authentification

Corps de la requête

Exemples

Réponse

Codes d’erreur

Commencer

Conversions

Référence API

​Endpoint

​Authentification

​Corps de la requête

​Exemples

​Réponse

​Codes d’erreur

Endpoint

Authentification

Corps de la requête

Exemples

Réponse

Codes d’erreur