Meldingen en e-mailtemplates

Meldingen en e-mails

Kies welke e-mailmeldingen je voor een flipbook ontvangt en pas het onderwerp en de body aan die worden verstuurd bij nieuwe-lead-, nieuwe-weergave- en nieuwe-verkoop-gebeurtenissen.

API's die in deze discussie worden gebruikt

Iets onjuist of verouderd in deze gids?

Wat je kunt doen

Met deze endpoints beheer je de e-mailkant van één flipbook: welke gebeurtenissen je op de hoogte brengen, en wat die e-mails zeggen. Ermee kun je:

Configureren welke meldingen je ontvangt voor een flipbook (nieuwe lead, nieuwe weergave, nieuwe verkoop).
De Nieuwe Lead-e-mail aanpassen — het onderwerp en de body die bij een nieuwe-lead-gebeurtenis worden verstuurd.
De Nieuwe Weergave-e-mail aanpassen — het onderwerp en de body die bij een nieuwe-weergave-melding worden verstuurd.
De Nieuwe Verkoop-e-mail aanpassen — het onderwerp en de body die bij een nieuwe-verkoop-melding worden verstuurd.
Elke template terugzetten naar de standaard door lege waarden te sturen.

Voordat je begint

Een API-sleutel — meegestuurd op elk verzoek als de X-Api-Key-header of als Authorization: Bearer YOUR_API_KEY.
De {flipbookId} — de numerieke ID van de flipbook/het document. Die wordt teruggegeven door create-by-file / create-by-url (als ID) of door list. Elk endpoint hier neemt hem als padparameter.
Alle verzoeken gaan naar de basis-URL https://go.fliplink.me.

Elke request-body is form-urlencoded (geen JSON) — stuur de velden met --data-urlencode.

Meldingen configureren

Gebruik PUT /api/set-notifications/{flipbookId} om te configureren welke e-mailmeldingen je voor deze flipbook ontvangt (nieuwe lead, nieuwe weergave, nieuwe verkoop).

Body-velden (form-urlencoded):

NotificationsEmail — het bestemmingsadres waarnaar meldingsmails worden verstuurd. Op een nieuwe flipbook is dit standaard je account-e-mail; je kunt het wijzigen naar elk adres, of leeg meesturen om het te wissen.
IsSendEmailOnView — een boolean (true / false, standaard false) die de "bekeken"-e-mail aan- of uitzet. Zet het op true om een e-mail te ontvangen wanneer iemand de flipbook bekijkt. Het voorbeeld hieronder stuurt 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'

Response:

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

De Nieuwe Lead-e-mailtemplate instellen

Gebruik PUT /api/set-email-template-lead/{flipbookId} om de e-mail in te stellen die bij een nieuwe-lead-gebeurtenis wordt verstuurd. Stuur lege waarden om de standaard-NEW_LEAD-template terug te zetten.

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='

Response:

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

De Nieuwe Weergave-e-mailtemplate instellen

Gebruik PUT /api/set-email-template-view/{flipbookId} om de e-mailtemplate in te stellen die bij een nieuwe-weergave-melding wordt verstuurd. Stuur leeg om de standaard-NEW_VIEW-template terug te zetten.

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='

Response:

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

De Nieuwe Verkoop-e-mailtemplate instellen

Gebruik PUT /api/set-email-template-sale/{flipbookId} om de e-mailtemplate in te stellen die bij een nieuwe-verkoop-melding wordt verstuurd. Stuur leeg om de standaard-NEW_SALE-template terug te zetten.

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='

Response:

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

Mogelijke fouten

Ontbrekende of ongeldige API-sleutel → HTTP 401. Dit geeft een kale Unauthorized-HTML-pagina terug — er is geen JSON-body. Controleer of de X-Api-Key-header (of Authorization: Bearer-token) aanwezig en correct is.
Item-ID niet gevonden of niet in eigendom van je sleutel → HTTP 200 met Message: "Item not found".
Onbekend of verkeerd gespeld body-veld → HTTP 200 met Message: "Unknown field(s) '…'. Expected: …".

Opmerkingen

De lead-, weergave- en verkoop-e-mailtemplates worden elk geleverd met ingebouwde standaardtekst. Het sturen van lege waarden zet de standaardtemplate van die gebeurtenis terug (respectievelijk NEW_LEAD, NEW_VIEW of NEW_SALE).
Merge-tokens gebruiken de ##TOKEN##-conventie — ##FLIPLINK## voegt bijvoorbeeld de naam van de flipbook in het onderwerp of de body in.