{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Tenant Sends an Invitation via Mail or SMS","siteUrl":"https://docs.bettermile.com","jsonLd":{"@context":"https://schema.org","@type":"Organization","name":"Bettermile","url":"https://bettermile.com","logo":"https://docs.bettermile.com/images/logo.png"},"description":"Requirements and integration steps for tenants who send their own mail or SMS tracking invitations to consignees."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"tenant-sends-an-invitation-via-mail-or-sms","__idx":0},"children":["Tenant Sends an Invitation via Mail or SMS"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dedicated invites must be sent to the consignee as early as possible to guarantee the full-scope tracking experience. Users benefit only from a timely correct notification, with the right content."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You need to use the availability information, to determine whether a parcel is available for real-time tracking or not."," ","When you want to customize invites fully and send the mail/SMS via your system, you must ensure that the consignee clearly understands how to track their parcel."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Integration of availability information ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["(“Push” via webhook)"]}," that should trigger Mail/SMS notifications"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Clear and dedicated message for consignee to visit the real-time tracking user interface"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Measuring key performance metrics such as Click-Through-Rate of invite emails/SMS and others"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When sending out Mail/SMS, respective UTM sources must be used. Example: for mail use: utm_source=invite-email"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ETAs must not be communicated in the invitations"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"technical-integration","__idx":2},"children":["Technical Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You need to send the real-time tracking invite to the consignee, the moment Bettermile informs you about the tracking availability for every parcel."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To do that you need to have a messaging service in place and maintain this constantly, additionally,  you need to ensure a secure way to send a large volume of notifications every day."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["To understand if a parcel is available for real-time tracking you must use the availability information via “Push” (webhook) and your integration must handle peak loads during truck loading times effectively."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["That means:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Support retry mechanisms and idempotency to handle transient failures without data duplication or loss"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure 99.9% uptime and processing of webhook events within 500 milliseconds to avoid piled-up messaging queues that would delay invites to consignees"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Industry incident management best practices including monitoring, alerting, and duty shifts during peak times"]}]}]},"headings":[{"value":"Tenant Sends an Invitation via Mail or SMS","id":"tenant-sends-an-invitation-via-mail-or-sms","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Technical Integration","id":"technical-integration","depth":2}],"frontmatter":{"title":"Tenant Sends an Invitation via Mail or SMS","rbac":{"anonymous":"read","authenticated":"read"},"seo":{"description":"Requirements and integration steps for tenants who send their own mail or SMS tracking invitations to consignees.","title":"Tenant Sends an Invitation via Mail or SMS"}},"lastModified":"2026-10-01T11:41:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/tracking/shadow-orchestrate/invitations/tenant","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}