Notificaciones y plantillas de correo

Qué puedes hacer

Estos endpoints te permiten controlar el lado del correo de un mismo flipbook: qué eventos te notifican y qué dicen esos correos. Con ellos puedes:

• Configurar qué notificaciones recibes para un flipbook (nuevo lead, nueva vista, nueva venta).
• Personalizar el correo de New Lead — el asunto y el cuerpo que se envían en un evento de nuevo lead.
• Personalizar el correo de New View — el asunto y el cuerpo que se envían en una notificación de nueva vista.
• Personalizar el correo de New Sale — el asunto y el cuerpo que se envían en una notificación de nueva venta.
• Restaurar cualquier plantilla a su valor predeterminado enviando valores vacíos.

Antes de empezar

• Una clave de API — se envía como el encabezado X-Api-Key o como Authorization: Bearer YOUR_API_KEY en cada solicitud.
• El {flipbookId} — el ID numérico del flipbook/documento. Lo devuelve create-by-file / create-by-url (como ID) o list. Cada endpoint aquí lo toma como parámetro de ruta.
• Todas las solicitudes van a la URL base https://go.fliplink.me.

Cada cuerpo de solicitud es form-urlencoded (no JSON) — envía los campos con --data-urlencode.

Configurar notificaciones

Usa PUT /api/set-notifications/{flipbookId} para configurar qué notificaciones por correo recibes para este flipbook (nuevo lead, nueva vista, nueva venta).

Campos del cuerpo (form-urlencoded):

• NotificationsEmail — la dirección de destino a la que se envían los correos de notificación. En un flipbook nuevo toma por defecto el correo de tu cuenta; puedes cambiarla a cualquier dirección, o enviarla vacía para borrarla.
• IsSendEmailOnView — un booleano (true / false, por defecto false) que activa el correo de "visto". Ponlo en true para recibir un correo cuando alguien vea el flipbook. El ejemplo de abajo envía 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'

Respuesta:

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

Configurar la plantilla de correo de New Lead

Usa PUT /api/set-email-template-lead/{flipbookId} para definir el correo que se envía en un evento de nuevo lead. Envía valores vacíos para restaurar la plantilla predeterminada 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='

Respuesta:

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

Configurar la plantilla de correo de New View

Usa PUT /api/set-email-template-view/{flipbookId} para definir la plantilla de correo que se envía en una notificación de nueva vista. Envía valores vacíos para restaurar la plantilla predeterminada 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='

Respuesta:

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

Configurar la plantilla de correo de New Sale

Usa PUT /api/set-email-template-sale/{flipbookId} para definir la plantilla de correo que se envía en una notificación de nueva venta. Envía valores vacíos para restaurar la plantilla predeterminada 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='

Respuesta:

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

Errores posibles

• Clave de API ausente o no válida → HTTP 401. Esto devuelve una página HTML de "Unauthorized" sin formato sin cuerpo JSON. Comprueba que el encabezado X-Api-Key (o el token Authorization: Bearer) esté presente y sea correcto.
• ID de ítem no encontrado o no perteneciente a tu clave → HTTP 200 con Message: "Item not found".
• Campo del cuerpo desconocido o mal escrito → HTTP 200 con Message: "Unknown field(s) '…'. Expected: …".

Notas

• Las plantillas de correo de lead, vista y venta incluyen cada una un texto predeterminado integrado. Enviar valores vacíos restaura la plantilla predeterminada de ese evento (NEW_LEAD, NEW_VIEW o NEW_SALE respectivamente).
• Los tokens de fusión usan la convención ##TOKEN## — por ejemplo, ##FLIPLINK## inserta el nombre del flipbook en el asunto o el cuerpo.