TEC.DELIVERY
enesilru

WhatsApp Notifications Setup Guide for Tec.Delivery Clients via Twilio

Official WhatsApp Business API integration using Twilio

This guide explains how to connect WhatsApp notifications in Tec.Delivery using Twilio and the official WhatsApp Business Platform.

Tec.Delivery provides the technical integration inside the platform. The client is responsible for creating and configuring the Meta Business account, Twilio account, WhatsApp Sender, and approved WhatsApp templates.

Required Data for Tec.Delivery

Before configuring WhatsApp notifications in Tec.Delivery, prepare the following Twilio data:

Example ContentSid

HX28c6fb3250aadd68f200dd056bd2ee56

Part 1

Meta / Facebook Business Setup

Step 1. Create a Meta Business Account

Go to business.facebook.com.

Create or log in to your Meta Business account.

Step 2. Add Company Information

In Meta Business Manager, complete the company profile:

  • Legal company name
  • Business address
  • Company website
  • Business email
  • Business phone number
  • Country
  • Industry

Step 3. Prepare Business Verification Documents

Meta may request documents to verify your business:

  • Company registration certificate
  • Business license
  • Tax registration document
  • Utility bill or bank statement showing the company address
  • Website or domain proof

Step 4. Start Business Verification

Business Settings → Security Center → Business Verification

Start the verification process and follow Meta’s instructions.

Step 5. Enable Two-Factor Authentication

Business Settings → Security Center → Two-Factor Authentication

Enable two-factor authentication for business administrators.

Part 2

Twilio Account Setup

Step 1. Create a Twilio Account

Go to twilio.com.

Create a new Twilio account or log in to an existing account.

Step 2. Upgrade the Twilio Account

Billing → Upgrade

Add billing information and payment method for production usage.

Step 3. Find Account SID and Auth Token

Open the main Twilio Console Dashboard and copy:

  • Account SID
  • Auth Token
Auth Token is sensitive. Do not publish it or share it through unsecured channels.
Part 3

WhatsApp Sender Registration in Twilio

Step 1. Open WhatsApp Senders

Messaging → Senders → WhatsApp Senders

Step 2. Start WhatsApp Self Sign-up

Start the WhatsApp onboarding process and connect your Meta Business account.

Step 3. Select or Create a WhatsApp Business Account

During onboarding, select or create:

  • Meta Business Portfolio
  • WhatsApp Business Account, also called WABA
  • WhatsApp Business Profile

Step 4. Add WhatsApp Business Profile Information

  • Display name
  • Business category
  • Description
  • Website
  • Business email
  • Logo, if required

Step 5. Register a Dedicated Phone Number

The phone number must:

  • Be able to receive SMS or voice call during verification
  • Not be actively used in regular WhatsApp or WhatsApp Business mobile app
  • Be dedicated to WhatsApp Business API usage

Step 6. Wait for Approval

After approval, copy the WhatsApp Sender Number from Twilio.

Example WhatsApp Sender Number

+14155238886

Part 4

Creating WhatsApp Templates in Twilio

Step 1. Open Content Template Builder

Messaging → Content Template Builder

Step 2. Create a Template for Order Status Notifications

Example template

Your order #{{1}} status has changed. New status: {{2}} Thank you for your order.

Step 3. Add Template Variables

Use numbered placeholders: {{1}}, {{2}}, {{3}}.

Step 4. Submit the Template for WhatsApp Approval

The template must comply with WhatsApp and Twilio rules.

Step 5. Copy Template ContentSid

Example ContentSid

HX28c6fb3250aadd68f200dd056bd2ee56

Part 5

Tec.Delivery Configuration

Step 1. Add Twilio / WhatsApp Account

Twilio Account Statuses & Path → Twilio/WA Account → + Add
Field Value
Name Any internal account name
Account SID Twilio Account SID
Token Twilio Auth Token
Sender WhatsApp Sender Number, for example +14155238886

Click Save.

Step 2. Configure WhatsApp Notification for Order Status

Twilio Status Statuses & Path → Order Status → [Status] → WhatsApp via Twilio

Enable:

Send notification to WhatsApp via Twilio

Step 3. Enter Template SID

Enter the approved Twilio ContentSid.

Step 4. Configure Variables

Variable Description
user_name Customer name
user_phone Customer phone number
order_id Order number
order_security_code Order verification code
order_status Current order status
order_left_time Remaining estimated delivery time in minutes
Example mapping

Twilio template: Your order #{{1}} status has changed. New status: {{2}} Tec.Delivery variables: 1 → order_id 2 → order_status

Click Save.

Testing

  1. Create a test order.
  2. Use a customer phone number that can receive WhatsApp messages.
  3. Change the order status in Tec.Delivery.
  4. Verify that the WhatsApp notification is received.
  5. Check Twilio logs if the message is not delivered.
Twilio Console → Monitor → Logs → Messaging

Important Notes

Final Checklist