Integrate Inxmail in Calenso

Created by Calenso Support, Modified on Wed, 19 Jun, 2024 at 5:24 PM by Calenso Support

Do you want notifications to be sent to your customers and your company via your Inxmail account instead of Calenso? This is now possible with the Inxmail integration.

TABLE OF CONTENT

What Subscription do I need to use this feature?
Where can I set up the connection to Inxmail?
Which credentials are needed?
Which notifications can be sent via Inxmail?
How is the data structured for each event?
What is the benefit?

What Subscription do I need to use this feature?

This feature is available to all our Enterprise-Partners.

Where can I set up the connection to Inxmail?

Under Settings you can find the Inxmail under the section Integrations:

Which credentials are needed?

To establish a connection to Inxmail, the following credentials are needed:

API-URL
API-ID
API-Secret
Expiry date of the API Secret

Which notifications can be sent via Inxmail?

The following notifications can be sent via Inxmail:

New booking: Notification to customer
New booking: Notification to partner
Reminder for customer
Rebooking: Notification for customer
Rebooking: Notification for partner
Cancellation: Notification for customer
Cancellation: Notification for partner
Smart Action: Survey after the appointment
Smart Actions: Notification before the appointment
Smart Actions: Thank you-mail after the appointment

How is the data structured for each event?

New booking: Notification to customer

Event: calenso.booking.inform-customer

{
    "event": "calenso.booking.inform-customer",
    "payload": {
        "customer": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
            "prename": "Xxxxxxx",
            "lastname": "Xxxxxxx"
            "email": "xxxxxxxx@xxxxxxx.com",
            "language": "de",
            "salutation": "m"
        },
        "worker": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
            "full_name": "Xxxxx Xxxxx",
            "prename": "Xxxxxx",
            "lastname": "Xxxxxx",
            "email": "xxxxxx.xxxxxx@xxxxxx.com"
        },
        "appointment": {
          "id": 10000,
          "start": "2021-03-30T18:05:00+00:00",
          "end": "2021-03-30T19:05:00+00:00",
          "title": "Termin mit Xxxxxx Xxxxxxx",
          "description": "Gebuchte Dienstleistungen: xyz",
          "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
          "remarks": "Ich freue mich auf den Termin :)",
          "url": "https://dashboard.calenso.com/appointments/f7e9b446-12a7-4085-ac85-XXXXXXXXX"
          "rebook_reason": null,
          "cancellation_reason": null
        }
    },
    "attachments": [
      {
          "filename": "Termin.ics",
          "content-type": "text/calendar",
          "content": "QkVHSU46VkNBTEVOREFSClZFUlNJT04XXXXXXXX[...]"    
      }
    ]
}

New booking: Notification to partner

Event: calenso.booking.inform-partner

{
    "event": "calenso.booking.inform-partner",
    "payload": {
        "customer": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXXX",
            "prename": "XXXXXX",
            "lastname": "XXXXXXX"
            "email": "xxxxxxxx@xxxxxx.com",
            "language": "de",
            "salutation": "m"
        },
        "worker": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
            "full_name": "Xxxxxxx Xxxxxx",
            "prename": "Xxxxxx",
            "lastname": "Xxxxxxx",
            "email": "xxxxxx.xxxxx@xxxxx.com"
        },
        "appointment": {
          "id": 10000,
          "start": "2021-03-30T18:05:00+00:00",
          "end": "2021-03-30T19:05:00+00:00",
          "title": "Termin mit Xxxxxx Xxxxxx",
          "description": "Gebuchte Dienstleistungen: xyz",
          "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXXX",
          "remarks": "Ich freue mich auf den Termin :)",
          "url": "https://dashboard.calenso.com/appointments/f7e9b446-12a7-4085-ac85-XXXXXXX"
          "rebook_reason": null,
          "cancellation_reason": null
        }
    },
    "attachments": [
      {
          "filename": "Termin.ics",
          "content-type": "text/calendar",
          "content": "QkVHSU46VkNBTEVOREFSClZFUlNJT046XXXXXXX[...]"    
      }
    ]
}

Reminder for customer

Event: calenso.booking.remind-customer

{
    "event": "calenso.booking.inform-customer",
    "payload": {
        "customer": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXX",
            "prename": "Xxxxxx",
            "lastname": "Xxxxxxx"
            "email": "xxxxxxx@xxxxxx.com",
            "language": "de",
            "salutation": "m"
        },
        "worker": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
            "full_name": "Xxxxxx Xxxxxx",
            "prename": "Xxxxxx",
            "lastname": "Xxxxxxx",
            "email": "xxxxxxx.xxxxxx@xxxxxx.com"
        },
        "appointment": {
          "id": 10000,
          "start": "2021-03-30T18:05:00+00:00",
          "end": "2021-03-30T19:05:00+00:00",
          "title": "Termin mit Xxxxxxx Xxxxxx",
          "description": "Gebuchte Dienstleistungen: xyz",
          "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXXX",
          "remarks": "Ich freue mich auf den Termin :)",
          "url": "https://dashboard.calenso.com/appointments/f7e9b446-12a7-4085-ac85-XXXXXXXX"
          "rebook_reason": null,
          "cancellation_reason": null
        }
    },
    "attachments": [
      {
          "filename": "Termin.ics",
          "content-type": "text/calendar",
          "content": "QkVHSU46VkNBTEVOREFSClZFUlNJT046Mi4wClXXXXX[...]"    
      }
    ]
}

Rebooking: Notification for customer

Event: calenso.booking.rebook.inform-customer

{
    "event": "calenso.booking.cancel.inform-customer",
    "payload": {
        "customer": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXX",
            "prename": "Xxxxxxx",
            "lastname": "Xxxxxx"
            "email": "xxxxxxx@xxxxxxx.com",
            "language": "de",
            "salutation": "m"
        },
        "worker": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
            "full_name": "Xxxxxx Xxxxxx",
            "prename": "Xxxxxx",
            "lastname": "Xxxxxxx",
            "email": "xxxxxx.xxxxx@xxxxx.com"
        },
        "appointment": {
          "id": 10000,
          "start": "2021-03-30T18:05:00+00:00",
          "end": "2021-03-30T19:05:00+00:00",
          "title": "Termin mit Xxxxxx Xxxxxx",
          "description": "Gebuchte Dienstleistungen: xyz",
          "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
          "remarks": "Ich freue mich auf den Termin :)",
          "url": "https://dashboard.calenso.com/appointments/f7e9b446-12a7-4085-ac85-XXXXXXX"
          "rebook_reason": "Ich habe einen Arzttermin",
          "cancellation_reason": "Ich fühle mich unwohl"
        },
        "original_appointment": {
          "id": 10000,
          "start": "2021-02-30T18:05:00+00:00",
          "end": "2021-02-30T19:05:00+00:00",
          "title": "Termin mit Patrick Breiter",
          "description": "Gebuchte Dienstleistungen: xyz",
          "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
          "remarks": "Ich freue mich auf den Termin :)",
          "url": "https://dashboard.calenso.com/appointments/f7e9b446-12a7-4085-ac85-XXXXXXX"
          "rebook_reason": null,
          "cancellation_reason": null
        }
    },
    "attachments": [
      {
          "filename": "Termin.ics",
          "content-type": "text/calendar",
          "content": "QkVHSU46VkNBTEVOREFSClZFUlNJT046Mi4wClXXXXXX[...]"    
      }
    ]
}

Rebooking: Notification for partner

Event: calenso.booking.rebook.inform-partner

{
    "event": "calenso.booking.cancel.inform-customer",
    "payload": {
        "customer": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
            "prename": "Xxxxxxx",
            "lastname": "Xxxxxxx"
            "email": "xxxxxxxx@xxxxxxx.com",
            "language": "de",
            "salutation": "m"
        },
        "worker": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXXX",
            "full_name": "Xxxxxxx Xxxxxxx",
            "prename": "Xxxxxxx",
            "lastname": "Xxxxxxx",
            "email": "xxxxxxx.xxxxxx@xxxxxx.com"
        },
        "appointment": {
          "id": 10000,
          "start": "2021-03-30T18:05:00+00:00",
          "end": "2021-03-30T19:05:00+00:00",
          "title": "Termin mit Patrick Breiter",
          "description": "Gebuchte Dienstleistungen: xyz",
          "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXXX",
          "remarks": "Ich freue mich auf den Termin :)",
          "url": "https://dashboard.calenso.com/appointments/f7e9b446-12a7-4085-ac85-XXXXXXXX"
          "rebook_reason": "Ich habe einen Arzttermin",
          "cancellation_reason": "Ich fühle mich unwohl"
        },
        "original_appointment": {
          "id": 10000,
          "start": "2021-02-30T18:05:00+00:00",
          "end": "2021-02-30T19:05:00+00:00",
          "title": "Termin mit Xxxxxx Xxxxxx",
          "description": "Gebuchte Dienstleistungen: xyz",
          "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXXX",
          "remarks": "Ich freue mich auf den Termin :)",
          "url": "https://dashboard.calenso.com/appointments/f7e9b446-12a7-4085-ac85-XXXXXX"
          "rebook_reason": null,
          "cancellation_reason": null
        }
    },
    "attachments": [
      {
          "filename": "Termin.ics",
          "content-type": "text/calendar",
          "content": "QkVHSU46VkNBTEVOREFSClZFUlNJT046MiXXXXXXX[...]"    
      }
    ]
}

Cancellation: Notification for customer

Event: calenso.booking.cancel.inform-customer

{
    "event": "calenso.booking.cancel.inform-customer",
    "payload": {
        "customer": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXX",
            "prename": "Xxxxxxx",
            "lastname": "Xxxxxxx"
            "email": "xxxxxxxx@xxxxxxx.com",
            "language": "de",
            "salutation": "m"
        },
        "worker": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
            "full_name": "Xxxxxxx Xxxxxx",
            "prename": "Xxxxxxx",
            "lastname": "Xxxxxxx",
            "email": "xxxxxx.xxxxx@xxxxxx.com"
        },
        "appointment": {
          "id": 10000,
          "start": "2021-03-30T18:05:00+00:00",
          "end": "2021-03-30T19:05:00+00:00",
          "title": "Termin mit Xxxxxx Xxxxxx",
          "description": "Gebuchte Dienstleistungen: xyz",
          "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXx",
          "remarks": "Ich freue mich auf den Termin :)",
          "url": "https://dashboard.calenso.com/appointments/f7e9b446-12a7-4085-ac85-XXXXXXX"
          "rebook_reason": null,
          "cancellation_reason": null
        }
    }
}

Cancellation: Notification for partner

Event: calenso.booking.cancel.inform-partner

{
    "event": "calenso.booking.cancel.inform-partner",
    "payload": {
        "customer": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXX",
            "prename": "Xxxxx",
            "lastname": "Xxxxxx"
            "email": "xxxxxxx@xxxxxx.com",
            "language": "de",
            "salutation": "m"
        },
        "worker": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXXX",
            "full_name": "Xxxxxxx Xxxxxxx",
            "prename": "Xxxxxxx",
            "lastname": "Xxxxxx",
            "email": "xxxxx.xxxxx@xxxxx.com"
        },
        "appointment": {
          "id": 10000,
          "start": "2021-03-30T18:05:00+00:00",
          "end": "2021-03-30T19:05:00+00:00",
          "title": "Termin mit Xxxxxx Xxxxx",
          "description": "Gebuchte Dienstleistungen: xyz",
          "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXXX",
          "remarks": "Ich freue mich auf den Termin :)",
          "url": "https://dashboard.calenso.com/appointments/f7e9b446-12a7-4085-ac85-XXXXXXXXX"
          "rebook_reason": null,
          "cancellation_reason": null
          "deleted": "2021-03-30T18:05:00+00:00"
        }
    }
}

Smart Action: Survey after the appointment

Event: calenso.smart-action.survey-after-appointment.inform-customer

{
    "event": "calenso.smart-action.survey-after-appointment.inform-customer",
    "payload": {
        "customer": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
            "prename": "Xxxxxx",
            "lastname": "Xxxxxxx"
            "email": "xxxxxx@xxxxxxx.com",
            "language": "de",
            "salutation": "m"
        },
        "worker": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
            "full_name": "Xxxxxx Xxxxxx",
            "prename": "Xxxxxxxx",
            "lastname": "Xxxxxx",
            "email": "xxxxxxx.xxxxx@xxxxxxxx.com"
        },
        "appointment": {
          "id": 10000,
          "start": "2021-03-30T18:05:00+00:00",
          "end": "2021-03-30T19:05:00+00:00",
          "title": "Termin mit Xxxxxxx Xxxxxxx",
          "description": "Gebuchte Dienstleistungen: xyz",
          "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXXX",
          "remarks": "Ich freue mich auf den Termin :)",
          "url": "https://dashboard.calenso.com/appointments/f7e9b446-12a7-4085-ac85-XXXXXXX"
          "rebook_reason": null,
          "cancellation_reason": null
        }
    }
}

Smart Actions: Notification before the appointment

Event: calenso.smart-action.notification-before-appointment.inform-customer

{
    "event": "calenso.smart-action.notification-before-appointment.inform-customer",
    "payload": {
        "customer": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXX",
            "prename": "Xxxxxxx",
            "lastname": "Xxxxxxx"
            "email": "xxxxxxx@xxxxxxx.com",
            "language": "de",
            "salutation": "m"
        },
        "worker": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXX",
            "full_name": "Xxxxxxx Xxxxxxx",
            "prename": "Xxxxxx",
            "lastname": "Xxxxxxx",
            "email": "xxxxxxx.xxxxx@xxxxxx.com"
        },
        "appointment": {
          "id": 10000,
          "start": "2021-03-30T18:05:00+00:00",
          "end": "2021-03-30T19:05:00+00:00",
          "title": "Termin mit Xxxxxx Xxxxxx",
          "description": "Gebuchte Dienstleistungen: xyz",
          "uuid": "f7e9b446-12a7-4085-ac85-5b80d7740ab8",
          "remarks": "Ich freue mich auf den Termin :)",
          "url": "https://dashboard.calenso.com/appointments/f7e9b446-12a7-4085-ac85-XXXXXXXX"
          "rebook_reason": null,
          "cancellation_reason": null
        }
    },
    "attachments": [
      {
          "filename": "Termin.ics",
          "content-type": "text/calendar",
          "content": "QkVHSU46VkNBTEVOREFSClZFUlNJT046Mi4wClBXXXXXXX[...]"    
      }
    ]
}

Smart Actions: Thank you-mail after the appointment

Event: calenso.smart-action.thank-you-after-appointment.inform-customer

{
    "event": "calenso.smart-action.thank-you-after-appointment.inform-customer",
    "payload": {
        "customer": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
            "prename": "Xxxxxxx",
            "lastname": "Xxxxxxx"
            "email": "xxxxxxx@xxxxxx.com",
            "language": "de",
            "salutation": "m"
        },
        "worker": {
            "id": 10000,
            "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
            "full_name": "Xxxxxxx Xxxxxx",
            "prename": "Xxxxxx",
            "lastname": "Xxxxxxx",
            "email": "xxxxxxx.xxxxxx@xxxxxx.com"
        },
        "appointment": {
          "id": 10000,
          "start": "2021-03-30T18:05:00+00:00",
          "end": "2021-03-30T19:05:00+00:00",
          "title": "Termin mit Xxxxxx Xxxxxx",
          "description": "Gebuchte Dienstleistungen: xyz",
          "uuid": "f7e9b446-12a7-4085-ac85-XXXXXXX",
          "remarks": "Ich freue mich auf den Termin :)",
          "url": "https://dashboard.calenso.com/appointments/f7e9b446-12a7-4085-ac85-XXXXXXXX"
          "rebook_reason": null,
          "cancellation_reason": null
        }
    }
}

What is the benefit?

All the above mentioned E-Mails can be designed completely independently so they can meet your CI entirely.

Was this article helpful?