Skip to content

Send OTP through Messcat API

Article Description: Learn how to send an OTP through Messcat’s message flow API Last Updated: August 4, 2021

Follow these steps to send OTPs to your clients through Messcat:

Step 1: Create a Message Flow

[https://drive.google.com/file/d/1aaIJFOxKYObkVtB4jdmvNrS_GkkIvmPA/view?usp=drive_link](https://drive.google.com/file/d/1aaIJFOxKYObkVtB4jdmvNrS_GkkIvmPA/view?usp=drive_link)

  1. Log in to Messcat and navigate to Automation > Message Flows.
  2. Create a new message flow by clicking the "+" button on the left sidebar.
  3. In the message flow editor, create a template with the message you want to send to your customer. Ensure you use the variable {{verificationCode}}.

Ex:

Hello {{name}} ! Here is your OTP: {{verificationCode}}

  1. Submit your flow for approval to WhatsApp. Once approved, you will be able to use this template to message your customers

Step 2: Submit the Template for Approval

[https://drive.google.com/file/d/1LiFEFy86LAp47w_eWa62xGgq4DRdG0QR/view?usp=drive_link](https://drive.google.com/file/d/1LiFEFy86LAp47w_eWa62xGgq4DRdG0QR/view?usp=drive_link)

  1. Once your message flow is created, you need to submit the template for approval to WhatsApp.
  2. Navigate to the three dot menu on the top right of your message flow and select "Submit for Approval"
  3. Select your WABA Channel and the message you want to send for approval. Also input the language of your message and select "Authentication" in Category

Step 3: Generate an API Token

[https://drive.google.com/file/d/1q7aIuF7Pyngc1H51AR7yBAIXjTfFejWq/view?usp=drive_link](https://drive.google.com/file/d/1q7aIuF7Pyngc1H51AR7yBAIXjTfFejWq/view?usp=drive_link)

  1. Navigate to the Developer section in Messcat and select API Token.
  2. Click on the "+Create" button to create a new API token.
  3. Give your API token a name, for example, "OTP Token".
  4. Assign the necessary scope to it and click Save:
    1. Access to Messages to All: MESSAGES_SEND_TO_ALL
  5. Copy the generated API Token

Step 4: Use the API Token to Send OTPs

  1. With your API token ready, you can now use it to send OTPs programmatically.
  2. Use the bots/{id}/fire API endpoint to send the message flow you created earlier. Refer to the API Documentation for more details.

Requirements for the API Request

  • Your API Token: "Bearer" + Space( ) + The token you generated in Step 3. For example: Bearer apit_KjLAhuzJIdAA9SpZfLEUOAMs8D1450k16ppuRW
  • The bot ID: The ID of the message flow you created in Step 1. This can be found at the end of the URL of your message flow. For example, if your URL is https://www.app.Messcat.tech/automation/messageFlows/addEdit/bot_8d3b30d69965baf7 , your bot ID would be bot_8d3b30d69965baf7.
  • Receiver's Phone Number: The phone number of the recipient with the country code.
  • Your Account ID(optional): In case you have multiple channels, you can select which channel you want to send the message from by going to "Manage Channels" and copying the ID of your channel
  • Pre-generated OTP: The OTP you want to send to your client.

Example Code

Here's an example of how to send an OTP using the Messcat API. You will need to replace the variables in bold with actual values

YOUR_BOT_ID : bot_8d3b30d69965baf7

YOUR_API_TOKEN : Bearer apit_KjLAhuzJIdAA9SpZfLEUOAMs8D1450k16ppuRW

YOUR_ACCOUNT_ID : acc_36dce712-a9eb-4275-96_ca8s

CONTACT_WITH_COUNTRY_CODE : 918074906794

YOUR_OTP : 123456

`const url = 'https://api-bots.Messcat.tech/bots/YOUR_BOT_ID/fire'; const options = { method: 'POST', headers: { 'Content-Type': 'application/json', Accept: 'application/json', Authorization: 'Bearer YOUR_API_TOKEN' }, body: JSON.stringify({ accountId: 'YOUR_ACCOUNT_ID', toContact: 'CONTACT_WITH_COUNTRY_CODE' parameters: { verificationCode: 'YOUR_OTP' } }) };

try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); }`

Conclusion

By following these steps, you can set up a system to send OTPs to your clients through Messcat. If you have any further questions or need assistance, feel free to contact our support team.