Notifiche e modelli email

Cosa puoi fare

Questi endpoint ti permettono di controllare il lato email di un singolo flipbook: quali eventi ti notificano e cosa dicono quelle email. Con essi puoi:

• Configurare quali notifiche ricevi per un flipbook (nuovo lead, nuova visualizzazione, nuova vendita).
• Personalizzare l'email New Lead — l'oggetto e il corpo inviati per un evento di nuovo lead.
• Personalizzare l'email New View — l'oggetto e il corpo inviati per una notifica di nuova visualizzazione.
• Personalizzare l'email New Sale — l'oggetto e il corpo inviati per una notifica di nuova vendita.
• Ripristinare qualsiasi modello al valore predefinito inviando valori vuoti.

Prima di iniziare

• Una chiave API — inviata come header X-Api-Key o come Authorization: Bearer YOUR_API_KEY in ogni richiesta.
• Il {flipbookId} — l'ID numerico del flipbook/documento. Viene restituito da create-by-file / create-by-url (come ID) o da list. Ogni endpoint qui lo accetta come parametro nel percorso.
• Tutte le richieste vanno all'URL di base https://go.fliplink.me.

Ogni body di richiesta è form-urlencoded (non JSON) — invia i campi con --data-urlencode.

Configurare le notifiche

Usa PUT /api/set-notifications/{flipbookId} per configurare quali notifiche email ricevi per questo flipbook (nuovo lead, nuova visualizzazione, nuova vendita).

Campi del body (form-urlencoded):

• NotificationsEmail — l'indirizzo di destinazione a cui vengono inviate le email di notifica. Su un flipbook nuovo è predefinito all'email del tuo account; puoi cambiarlo con qualsiasi indirizzo, o inviarlo vuoto per azzerarlo.
• IsSendEmailOnView — un boolean (true / false, predefinito false) che attiva/disattiva l'email di "visualizzato". Impostalo a true per ricevere un'email quando qualcuno visualizza il flipbook. L'esempio qui sotto invia 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'

Risposta:

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

Impostare il modello email New Lead

Usa PUT /api/set-email-template-lead/{flipbookId} per impostare l'email inviata per un evento di nuovo lead. Invia valori vuoti per ripristinare il modello predefinito NEW_LEAD.

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

Risposta:

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

Impostare il modello email New View

Usa PUT /api/set-email-template-view/{flipbookId} per impostare il modello email inviato per una notifica di nuova visualizzazione. Invia vuoto per ripristinare il modello predefinito NEW_VIEW.

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

Risposta:

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

Impostare il modello email New Sale

Usa PUT /api/set-email-template-sale/{flipbookId} per impostare il modello email inviato per una notifica di nuova vendita. Invia vuoto per ripristinare il modello predefinito NEW_SALE.

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

Risposta:

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

Errori possibili

• Chiave API mancante o non valida → HTTP 401. Restituisce una semplice pagina HTML di Unauthorized — non c'è alcun body JSON. Controlla che l'header X-Api-Key (o il token Authorization: Bearer) sia presente e corretto.
• ID dell'elemento non trovato o non di proprietà della tua chiave → HTTP 200 con Message: "Item not found".
• Campo del body sconosciuto o scritto male → HTTP 200 con Message: "Unknown field(s) '…'. Expected: …".

Note

• I modelli email di lead, visualizzazione e vendita includono ciascuno un testo predefinito integrato. Inviare valori vuoti ripristina il modello predefinito di quell'evento (rispettivamente NEW_LEAD, NEW_VIEW o NEW_SALE).
• I merge token usano la convenzione ##TOKEN## — per esempio, ##FLIPLINK## inserisce il nome del flipbook nell'oggetto o nel corpo.