Webhooks

Les webhooks permettent de recevoir automatiquement les informations des prospects sur votre endpoint. Configurez un webhook par entreprise depuis votre tableau de bord.

Format des données envoyées

Lorsqu'un prospect partage ses coordonnées via une ECARD, une requête POST est envoyée à votre endpoint avec le corps JSON suivant :

{
  "id": "fjgfskng",
  "firstname": "John",
  "lastname": "Doe",
  "phone": "0600000000",
  "email": "john.doe@ecard.fr",
  "notes": "note, keyword",
  "job_title": "Developer - TechCorp",
  "date": "2024-09-12",
  "meeting_location": "Salon Tech Paris",
  "ecard_source": "xxxxxx",
  "ecard_firstname": "Jane",
  "ecard_lastname": "Doe",
  "ecard_email": "j.doe@company.com"
}

Description des champs

Champ	Type	Description
id	string	Identifiant unique du prospect
firstname	string	Prénom du prospect
lastname	string	Nom du prospect
phone	string	Numéro de téléphone du prospect
email	string (email)	Adresse email du prospect
notes	string	Mots-clés décrivant le prospect (ajoutés manuellement après création)
job_title	string	Poste et/ou entreprise du prospect
date	string	Date de création du prospect (format : YYYY-MM-DD)
meeting_location	string	Lieu de rencontre (ajouté manuellement après création)
ecard_source	string	Slug de l'ECARD utilisée par le prospect
ecard_firstname	string	Prénom du propriétaire de l'ECARD
ecard_lastname	string	Nom du propriétaire de l'ECARD
ecard_email	string (email)	Email du propriétaire de l'ECARD

Codes de réponse HTTP

Code	Signification
200	Requête réussie
400	Requête invalide (vérifiez le format des données)
401	Authentification échouée (vérifiez vos clés API)
403	Accès refusé (vous n'avez pas accès à cette ECARD)
404	ECARD non trouvée
500	Erreur serveur