PowerPlatformConnectors/certified-connectors/tyntec-WA

Tyntec Conversations API - Send template WhatsApp message

Tyntec Conversations API allows you to send template WhatsApp messages.

Create conversational experiences with your customers right on the world’s number one messaging app (over 2 billion monthly active users). Leveraging WhatsApp’s end-to-end encryption and rich features (images, videos, audios, documents, interactive buttons, etc.), you can remove friction from customer onboarding, notifications and support communication.

Use Cases of this connector

• Use this connector in PowerApps Workflows (great for Marketing, CRM or Sales)
• Send SMS messages using Azure Logic Apps
• Build SMS support in your Microsoft Power Automate automatizations

And many more!

Pre-requisites

You will need the following to proceed:

• A Microsoft Power Apps or Power Automate plan with custom connector feature
• tyntec API Key
• WhatsApp Business account number provide by tyntec
• WhatsApp Message Template approved by WhatsApp

Supported requests

• Send WhatsApp using tyntec Conversations API reference Sends template message

  • To make a successful request, please, populate the followings fields:
    • to - receiver's phone number in international form without leading 00 (E.g. 4989202451100)
    • from - your WhatsApp Business account number number
    • templateId - the name of your approved template
    • language-policy - language policy of your template
    • language-code - language code of your template
    • components type - use body if you are sending text. Rich media use header
    • type of parameter - use text if sending text, rich media uses media
    • parameter-url - input the source url
    • parameter-type - type of used media - support image, document and video
    • parameter-filename - filename for your rich media
    • parameter-text - input your text message
    • if your template uses more parameters, repeat parameter-type and parameter-text for each parameter your template requires

• WhatsApp Free-Form Message

  • Sends a free form message
    • to - receiver's phone number in international form without leading 00 (E.g. 4989202451100)
    • from - your WhatsApp Business account number number
    • contentType - use text if you are sending text
    • text - input your text message

• Status Check

  • To make a successful status check, please, provide the connector with the following values
    • id - messageID of your message (returned after each request)

Supported Triggers

• Incoming Message Trigger any flow on new incoming messages
  • Response Fields
    • messageId (the message ID)
    • channel - the channel on which the message was received (viber, whatsapp or sms)
    • from - the sender's phone number
    • to - the reciever's phone number (you)
    • receivedAt - when was the message received
    • text - the text of the message
    • file - any attached file to the message
    • event - on which event the webhook was triggered
    • timestamp - the timestamp of the message

How to get API key

Please sign up for a free account. In your account, select the API settings and copy your API key.

Deployment instructions

Please use these instructions to deploy this connector as a custom connector in Microsoft Power Automate and Power Apps.