Notifications et modèles d'e-mail

Ce que tu peux faire

Ces endpoints te permettent de contrôler le volet e-mail d'un seul flipbook : quels événements te notifient, et ce que disent ces e-mails. Avec eux, tu peux :

• Configurer les notifications que tu reçois pour un flipbook (nouveau prospect, nouvelle vue, nouvelle vente).
• Personnaliser l'e-mail Nouveau prospect — l'objet et le corps envoyés lors d'un événement nouveau prospect.
• Personnaliser l'e-mail Nouvelle vue — l'objet et le corps envoyés lors d'une notification de nouvelle vue.
• Personnaliser l'e-mail Nouvelle vente — l'objet et le corps envoyés lors d'une notification de nouvelle vente.
• Restaurer n'importe quel modèle à sa valeur par défaut en envoyant des valeurs vides.

Avant de commencer

• Une clé d'API — envoyée soit dans l'en-tête X-Api-Key, soit via Authorization: Bearer YOUR_API_KEY à chaque requête.
• Le {flipbookId} — l'ID numérique du flipbook/document. Il est renvoyé par create-by-file / create-by-url (sous la forme ID) ou par list. Chaque endpoint ici le prend comme paramètre de chemin.
• Toutes les requêtes sont envoyées à l'URL de base https://go.fliplink.me.

Chaque corps de requête est au format form-urlencoded (pas JSON) — envoie les champs avec --data-urlencode.

Configurer les notifications

Utilise PUT /api/set-notifications/{flipbookId} pour configurer les notifications par e-mail que tu reçois pour ce flipbook (nouveau prospect, nouvelle vue, nouvelle vente).

Champs du corps (form-urlencoded) :

• NotificationsEmail — l'adresse de destination à laquelle les e-mails de notification sont envoyés. Sur un nouveau flipbook, elle correspond par défaut à l'e-mail de ton compte ; tu peux la remplacer par n'importe quelle adresse, ou l'envoyer vide pour l'effacer.
• IsSendEmailOnView — un booléen (true / false, false par défaut) qui active ou désactive l'e-mail « vue ». Mets-le à true pour recevoir un e-mail quand quelqu'un consulte le flipbook. L'exemple ci-dessous envoie true.

curl -X PUT 'https://go.fliplink.me/api/set-notifications/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'NotificationsEmail=you@example.com' \
  --data-urlencode 'IsSendEmailOnView=true'

Réponse :

{
  "Result": "OK",
  "Message": "Updated successfully"
}

Définir le modèle d'e-mail Nouveau prospect

Utilise PUT /api/set-email-template-lead/{flipbookId} pour définir l'e-mail envoyé lors d'un événement nouveau prospect. Envoie des valeurs vides pour restaurer le modèle NEW_LEAD par défaut.

curl -X PUT 'https://go.fliplink.me/api/set-email-template-lead/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'EmailLeadSubject=' \
  --data-urlencode 'EmailLeadBody='

Réponse :

{
  "Result": "OK",
  "Message": "Updated successfully"
}

Définir le modèle d'e-mail Nouvelle vue

Utilise PUT /api/set-email-template-view/{flipbookId} pour définir le modèle d'e-mail envoyé lors d'une notification de nouvelle vue. Envoie une valeur vide pour restaurer le modèle NEW_VIEW par défaut.

curl -X PUT 'https://go.fliplink.me/api/set-email-template-view/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'EmailViewSubject=' \
  --data-urlencode 'EmailViewBody='

Réponse :

{
  "Result": "OK",
  "Message": "Updated successfully"
}

Définir le modèle d'e-mail Nouvelle vente

Utilise PUT /api/set-email-template-sale/{flipbookId} pour définir le modèle d'e-mail envoyé lors d'une notification de nouvelle vente. Envoie une valeur vide pour restaurer le modèle NEW_SALE par défaut.

curl -X PUT 'https://go.fliplink.me/api/set-email-template-sale/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'EmailSaleSubject=' \
  --data-urlencode 'EmailSaleBody='

Réponse :

{
  "Result": "OK",
  "Message": "Updated successfully"
}

Erreurs possibles

• Clé d'API manquante ou invalide → HTTP 401. Renvoie une simple page HTML « Unauthorized » — il n'y a pas de corps JSON. Vérifie que l'en-tête X-Api-Key (ou le token Authorization: Bearer) est présent et correct.
• ID d'élément introuvable ou non associé à ta clé → HTTP 200 avec Message: "Item not found".
• Champ de corps inconnu ou mal orthographié → HTTP 200 avec Message: "Unknown field(s) '…'. Expected: …".

Notes

• Les modèles d'e-mail prospect, vue et vente sont chacun livrés avec un texte par défaut intégré. Envoyer des valeurs vides restaure le modèle par défaut de cet événement (NEW_LEAD, NEW_VIEW ou NEW_SALE respectivement).
• Les tokens de fusion utilisent la convention ##TOKEN## — par exemple, ##FLIPLINK## insère le nom du flipbook dans l'objet ou le corps.