September 2021

Welcome to tyntec’s release notes for September 2021! Learn what’s new in our products below.

🙋 Do you have any questions?
Get in touch with our team.

🖥️ Are you a developer?
Get notifications on Github in real-time once a new release is posted for tyntec’s products! 

Product What’s New Description
Conversations API New Media Endpoints Security Media endpoints can be completely secured, with credential settings of type basic (username & passwords) and oAuth2 (client_credentials flow) for downloading media files from your premise.
Conversations API / WhatsApp New feature: URL preview on the text message Select if an URL preview should be rendered on a text message.
Conversations API / WhatsApp Bug fixing Interactive button long caption correction to 20 characters instead of 24.
Conversations API / WhatsApp Flexible rollout of changes on MessageStatus and Inbound Messages Apply a transformation model on MessageStatus updates and inbound messages depending on the chosen version of a callback.
Conversations API / WhatsApp Integration with Microsoft Teams Receive WhatsApp messages and respond to them in Teams using a custom Teams bot.
Conversations API / WhatsApp Integration with Microsoft Bot Framework integrate a simple Echo bot built from the Microsoft Bot Framework with the WhatsApp channel in the tyntec Conversations API. This integration allows your bot to receive WhatsApp messages and reply to them with ease.
Self-service (across all products) Account self-service endpoints (beta) Leverage security with account IP restriction and API keys management.

New Media Endpoints Security

A new security enhancement for media endpoints to our Conversations API is available for versions 2 and 3. 

Now, the media endpoints can be completely secured, with credentials settings of type basic (username & password) and oAuth2 (client_credentials flow) for downloading media files from your premise.

We support 2 variants for this:

#1 - Basic Authentication with username and password

curl --location --request PUT 'https://api.tyntec.com/conversations/v3/configurations/mediaCredentials' \
--header 'apikey: <key>' \
--header 'Content-Type: application/json' \
--data-raw '{
     "type": "basic",
     "basic": {
         "username": "your username",
         "password": "your password"
     }
}'

#2 - oAuth2 using the client credentials flow

curl --location --request PUT 'https://api.tyntec.com/conversations/v3/configurations/mediaCredentials' \
--header 'apikey: <key> \
--header 'Content-Type: application/json' \
--data-raw '{
     "type": "oauth2",
     "oauth2": {
         "clientId": "your client id",
         "clientSecret": "your client secret",
         "url": "https://your.authentication.server.com"
     }
}'

Removing the credentials can be achieved via

curl --location --request DELETE 'https://api.tyntec.com/conversations/v3/configurations/mediaCredentials' --header 'apikey: <key>'

ℹ️ Need more information? The request is stored on the postman file in our GitHub repository.

Select if an URL preview should be rendered on a text message

Now, you can select if on a text message an URL preview should be rendered: 

{
    "from" : "{{whatsAppBusinessNumber}}",
    "to" : "{{receiverPhoneNumber}}",
    "channel" : "whatsapp",
    "content" : {
        "contentType" : "text",
        "text" : "test message 2",
        "renderUrlPreview" : true,
    }
}

ℹ️ This feature is available for Conversations API version 3.

Interactive button long caption correction to 20 characters, instead of 24

Bugfix to align our capabilities for interaction buttons captions to WhatApp’s API. 

ℹ️ This feature is available for Conversations API versions 2 and 3.

Flexible rollout of changes on MessageStatus and Inbound Messages

You can now apply a transformation model on MessageStatus updates and inbound messages depending on the chosen version of a callback. This allows tyntec to create new events and update the API structure without disruption to existing clients. You can edit such changes at your own pace, making it a safer process for your company.

ℹ️ This feature is available for Conversations API versions 2 and 3.

Integration with Microsoft Teams

Answer customers' WhatsApp messages right from your Microsoft Teams with tyntec’s integration tutorial. 

This integration will allow you to receive WhatsApp messages and respond to them in Teams using a custom Teams bot.

🎁 Note that this integration is already included in your WhatsApp package! 

⚠️ A subscription to Microsoft Teams is not included.

Integration with Microsoft Bot Framework

Are you looking for a solution to making your Microsoft bot accessible on WhatsApp? 

Learn in our Integration Tutorial how to integrate a simple Echo bot built from the Microsoft Bot Framework with the WhatsApp channel in the tyntec Conversations API. This integration allows your bot to receive WhatsApp messages and reply to them with ease.

🎁 Note that this integration is already included in your WhatsApp package! 

⚠️ A subscription to Microsoft Bot Framework is not included.

Account self-service endpoints (beta)

You can now use our account self-service endpoints to handle two new operations across all tyntec’s products:

Account IP restriction

The IP restriction API helps you manage your account and allowlist your IPs and subnets for higher security when using your tyntec API key.

Account Keys

The keys API helps you manage your account API keys. You can add a secondary key to your account and delete the old one. With this mechanism, you can safely rotate a key on runtime to keep your account safe.