Skip to main content

​
WhatsApp Setup

Connect your WhatsApp Business number to Tedro with Meta’s one-click Embedded Signup flow. This guide covers prerequisites, the connection process, messaging policies, and troubleshooting.

​
Prerequisites

Before connecting WhatsApp, make sure you have:
  • A Meta Business Account (business.facebook.com)
  • WhatsApp Business API access enabled on your Meta Business Account
  • A verified phone number registered with WhatsApp Business API (not a personal WhatsApp number)
  • A Tedro workspace with Admin role
If you don’t have WhatsApp Business API access yet, apply through the Meta Business Suite. Approval typically takes 1-2 business days.

​
Connecting Your Number

​
Webhook Configuration

Tedro automatically registers its webhook URL with Meta when you connect your number. The webhook endpoint is:
The platform handles:
  • Webhook verification (Meta’s challenge handshake)
  • Inbound message processing
  • Secure request validation
  • Duplicate message prevention
Do not manually modify the webhook URL in Meta’s App Dashboard unless instructed by Tedro support. Incorrect webhook configuration will prevent message delivery.

​
Testing Your Connection

After connecting:
  1. Go to Settings > Channels and click on your WhatsApp channel
  2. Click the Send Test Message button
  3. Enter a phone number to receive the test message
  4. Confirm that the message arrives on the target phone
If the test fails, check:
  • Your WhatsApp Business API phone number is properly verified in Meta Business Suite
  • The access token has the required permissions
  • Your Meta Business Account is not restricted or under review

​
WhatsApp Messaging Policies

WhatsApp enforces strict messaging policies that Tedro automatically respects at runtime. Understanding these policies is essential for building compliant workflows.

​
24-Hour Customer Service Window

WhatsApp only allows free-form messages within 24 hours of a customer’s last inbound message. This is called the “customer service window.”
  • Inside the window (within 24h of last customer message): You can send any free-form text message.
  • Outside the window (more than 24h since last customer message): You must use a pre-approved message template.
Tedro enforces this automatically. If a free-form message node tries to send outside the window, the runtime blocks it and logs an error in the run steps.

​
Opt-Out Handling

When a customer sends STOP, unsubscribe, or similar keywords:
  • Tedro automatically marks the contact as opted out
  • All messaging to that contact is halted — no further messages are sent, regardless of workflow logic
  • The contact must send a new message to re-engage (which clears the opt-out flag)
Opt-out handling is a WhatsApp policy requirement. Do not attempt to override or bypass it in your workflows.

​
Message Templates

WhatsApp message templates are pre-approved message formats required for outbound communication outside the 24-hour window. How templates work:
  1. Create templates in the Meta Business Suite under your WhatsApp Business Account
  2. Submit templates for Meta review (approval typically takes minutes to a few hours)
  3. Once approved, use the template name in your template message node configuration
  4. Templates support parameters — dynamic values like customer names, order numbers, etc.
Template categories:
  • Utility: Order updates, appointment reminders, shipping notifications
  • Marketing: Promotional offers, product announcements (stricter approval)
  • Authentication: One-time passwords, verification codes
Template approval is handled entirely by Meta. Tedro does not control the approval process. For detailed guidance, see Meta’s template documentation.

​
Handoff Requirement

Every published workflow in Tedro must have at least one reachable handoff node. This ensures that:
  • Customers can always reach a human agent
  • Complex issues that AI cannot resolve get proper attention
  • Your business remains compliant with WhatsApp’s customer service guidelines
The platform validates this at publish time and blocks publishing if no handoff path exists.

​
Channel Detail Page

Each connected WhatsApp channel has a dedicated detail page (accessible from Settings > Channels > [Channel Name]) showing:
  • Connection status and health indicators
  • Last webhook received timestamp
  • Message count in the last 24 hours
  • Associated workflow (if any)
  • Channel configuration and management options

​
Troubleshooting

​
What’s Next

Instagram DMs

Connect your Instagram account to receive and respond to direct messages.

Facebook Messenger

Handle Messenger conversations from your Facebook Page.

Inbox

Manage all your WhatsApp conversations from the unified inbox.