Setting Up WhatsApp Patient Communications

This framework means your pharmacy group retains full ownership of your business verification, templates, and messaging costs, while Deltera manages the heavy lifting—handling the sending logic, appointment scheduling triggers, branding, and toggle controls directly from your dashboard.

This self-serve guide walks you through the end-to-end setup process. Because you are managing your own infrastructure, please follow each step precisely to avoid onboarding delays.

0. Before You Start: Prerequisites Checklist

Gather these items first. Missing details or mismatches are the primary cause of setup delays:

• Payment Method: A corporate debit or credit card to fund the Twilio account.
• Company Records: Your registered company details matching official corporate records exactly. This includes your legal business name, registered address, company registration number, and your live business website domain.
• Verification Documents: An official business document for Meta verification (e.g. Certificate of Incorporation, VAT/tax document, or a recent business utility bill).
• Dedicated Phone Number: A phone number for WhatsApp that is not currently registered to any personal or business WhatsApp account. You can buy a fresh virtual number directly from Twilio during this setup if required.
• Meta Access: A Facebook login with full admin rights to your organisation's existing Meta Business Manager (or the ability to create a new profile).
• Time Allocation: Roughly 30–60 minutes for the hands-on configuration, followed by a few days of background processing time for Meta verification and template approvals.

1. Create Your Twilio Account

1. Register: Head to twilio.com/try-twilio and sign up using a corporate email address.
2. Verification: Verify both the email address and the mobile number that Twilio requests. Note that this initial mobile number is purely to secure your login, it is not your patient-facing WhatsApp sender.
3. Tailor Console: When prompted about what you are building, select WhatsApp / Messaging. This ensures the console surfaces the correct tools on your navigation menu.
4. Upgrade Account: Trial accounts cannot run live WhatsApp senders. Click Upgrade within the console and add your corporate card details to transition to a full paid account.
5. Secure Access: Navigate to Account → Security and enforce two-factor authentication (2FA) for every user. Ensure the primary account owner is tied to a shared head-office role or a permanent corporate inbox rather than an individual's personal login.

2. Fund Your Twilio Account

You pay Twilio directly for your actual network usage; Deltera never sits in the middle of your messaging costs or adds transactional markups.

1. Add Card: In the Twilio Console, navigate to Admin → Billing → Payment & billing and save your corporate card.
2. Initial Top-Up: Add a starting balance of around £50–£100. Saving a card does not automatically fund the account, and this starting credit will comfortably cover your initial phone number purchase, routing verification, and early messaging tests.
3. Enable Auto-Recharge: This is the most critical setting in this guide. Set a trigger balance (e.g. recharge when the account drops below £20) and a fixed top-up amount (e.g. automatically add £50). Without this active, your balance will eventually hit zero and your patient messages will silently fail.
4. Notifications: Optionally set a billing alert email address so your finance department is notified automatically whenever a recharge occurs.

Who Pays for What?You pay Twilio directly for two things: the monthly rental fee for your phone number, and a per-conversation WhatsApp charge. Meta’s WhatsApp conversation fees are automatically calculated and passed directly to your Twilio bill—meaning you only have one card to fund and one invoice to pull. Deltera charges nothing for the messaging volume itself. For live, up-to-date fees by country and message type, please consult Twilio's live WhatsApp pricing page.

3. Get a Phone Number & Set Up Your WhatsApp Sender

Choosing the Number

The number you allocate to WhatsApp must be entirely clear of any existing WhatsApp accounts.

• The Easiest Option: Buy a brand-new virtual number directly within the Twilio console (Phone Numbers → Manage → Buy a number), selecting a UK number configuration.
• Using an Existing Line: You can choose to route an existing business landline or mobile number, but it must be capable of receiving a voice call or SMS text containing a verification code during setup, and it cannot be currently active on the standard WhatsApp or WhatsApp Business mobile apps.

Completing the Public Sender Profile

During the registration process, you will configure the public profile that patients see on their phones. Prepare these assets in advance:

• Display Name: The official name shown to patients (e.g. your retail pharmacy brand name). Meta manually reviews and approves this; it must strictly reflect a real business and adhere to Meta's display-name rules (no URLs, no generic words like "Pharmacy" on its own, and no arbitrary ALL-CAPS or special characters unless they match your official trademark).
• Business Category: Select Health/Medical & pharmacy.
• Profile Assets: Upload a clean square logo, a brief business description, your head office address, website link, and a contact email address.

4. Set Up and Verify Your Meta Business Account

This step is handled by Meta and is where integrations most frequently stall if details are entered carelessly. Complete this early to give Meta time to review your documents.

Locate or Create Your Business Manager

Go to business.facebook.com. If your organisation already manages Facebook pages, Instagram accounts, or ad campaigns, use your existing Meta Business Manager rather than creating a duplicate portfolio. If you don't have one, select create and build a portfolio using your exact legal business name. Take a note of your Business Manager ID found under Business Settings → Business Info.

Complete Meta Business Verification

Navigate to Business Settings → Security Centre and initiate the Business Verification wizard. Meta will cross-reference your inputs against official registries to confirm your business is legitimate. Have the following ready:

• Legal business name exactly as registered with Companies House.
• Registered business address.
• Official company registration number.
• A verifiable business phone number (Meta may send an automated text or call to this number to verify ownership).
• Your active corporate website domain.

You must upload one clear, official document confirming these details, such as your Certificate of Incorporation, a formal business licence, a recent corporate bank statement, a VAT registration certificate, or a business utility bill. The name and address on the document must perfectly match your input fields.

Common Rejection Triggers: The most frequent causes for rejection are slight address or name discrepancies between your form entry and your uploaded paperwork, sending a document cropped or obscured, submitting documents in a personal director's name instead of the company name, or providing a website that fails to reference your legal company entity.

5. Link Your Sender to Meta (Embedded Signup)

This step securely bridges three environments: your Twilio configuration, your newly created WhatsApp Business Account (WABA), and your verified Meta Business Manager.

1. In the Twilio Console, open the WhatsApp Senders control panel and launch the Embedded Signup wizard.
2. Log in using the Facebook credentials that hold admin rights to your Meta Business Manager and grant the requested application permissions.
3. Select your verified Business Portfolio and choose to create a new WABA (or select an existing one if pre-configured).
4. Input your dedicated WhatsApp phone number from Step 3, choose your verification method (SMS or Voice Call), and enter the verification code received.
5. Complete the wizard and confirm that your sender status updates to connected and registered within your Twilio console.

Note: New WhatsApp senders automatically start with a standard tier messaging limit (a cap on how many unique customer-initiated conversations you can start per 24 hours). This limit automatically scales upwards as you maintain a healthy sender quality rating, so we advise a phased rollout rather than an immediate mass blast to your entire patient database.

6. Create and Approve Message Templates

WhatsApp strictly prohibits free-form, business-initiated messaging to prevent spam. Every automated alert sent by Deltera (confirmations, appointment reminders, authentication codes) must use a template pre-approved by Meta.

Understanding Template Categories

Template categories dictate both your approval odds and the direct cost per conversation:

• Utility: Transactional messages directly servicing an action the patient explicitly took (e.g. confirming a booking, a 24-hour reminder, clinical follow-ups). Almost all of your Deltera templates will fall under this category.
• Authentication: Strictly for user verification, such as sending one-time passcodes or multi-factor authentication (MFA) login codes.
• Marketing: Promotional offers, health events, or re-engagement campaigns. These carry the highest per-message costs and the strictest review parameters. Avoid marketing language in your core functional templates.

Building a Template

1. Navigate to Messaging → Content Template Builder inside your Twilio console.
2. Draft your message prose. For dynamic details that change per patient, utilise variables formatted exactly as {{1}}, {{2}}, {{3}}, etc.
3. You must provide a realistic sample value for each variable (e.g. replacing {{1}} with "Sarah" or {{2}} with "Weight Management Clinic") so Meta’s reviewers can understand the context of your message. Selecting a 'Utility' category but sneaking promotional wording or discounts into the text is the fastest way to get a template permanently rejected.
4. Submit for approval. Status updates usually happen anywhere from a few minutes to 24 hours. If rejected, review the provided feedback code, adjust your wording or category, and resubmit.

Required Templates to Create

Please build the following three foundational templates. You may subtly alter the surrounding wording to match your brand guidelines, but you must keep the data variables in this exact order:

• Appointment Confirmation (Utility): Hi {{1}}, your {{2}} appointment at {{3}} is confirmed for {{4}}. Reply if you need to change it.
• Appointment Reminder (Utility): Hi {{1}}, a reminder of your {{2}} appointment at {{3}} on {{4}}. See you then.
• MFA / One-Time Passcode (Authentication): {{1}} is your verification code.

(Should specific advanced clinical services require extra specialized templates in the future, our implementation team will provide you with the exact copy parameters required).

Alternative Option: Deltera Template Management

If you prefer not to draft these yourself, you can temporarily add Deltera to your infrastructure to handle the submission. Go to Admin → Manage Users → Invite and invite your designated Deltera onboarding contact with a localized Content/Messaging management role. Inform us once invited, and we will build and submit the standard configurations for you. You can safely remove our user access once the templates show as approved.

Patient Consent Warning: Before your system fires a message via WhatsApp, you must legally hold the patient's explicit opt-in consent to be contacted via that channel. Ensure your digital booking forms and in-pharmacy walk-in workflows have the WhatsApp consent box explicitly active.

7. Connect to Deltera: Credentials Secure Submission

To connect your messaging engine to your Deltera dashboard, we establish a connection using scoped, standard API keys. Never share your root account Auth Token.

1. In your Twilio Console, go to Account → API keys & tokens → Create API key.
2. Select a Standard key type and name it descriptive, such as "Deltera Integration".
3. Important: Twilio will display the API Secret exactly once on creation. Copy this code immediately and store it securely; it cannot be recovered or viewed again later.

Once generated, compile the following details and submit them to your Deltera account manager using the secure credential sharing channel provided to you (do not send these via standard plain-text email):

• Account SID: Found on your main console dashboard (a long string starting with AC...).
• API Key SID: Generated in the step above (starts with SK...).
• API Secret: The one-time code generated above.
• WhatsApp Sender Number: The dedicated phone number verified in Step 3.
• Approved Template Content SIDs: If you created the templates yourself, provide the unique identifier codes for each approved layout (these identifiers start with HX...).

You can revoke or delete this API key from your Twilio console at any moment to instantly isolate your system without altering your broader Twilio setup.

8. Expected Deployment Timeline

While the hands-on configuration takes less than an hour, the end-to-end activation relies heavily on external regulatory reviews. Plan your project launch around the following estimates:

• Twilio Account Setup, Funding, and Number Allocation: Same day.
• Meta Business Verification: Typically takes a few days, but can take up to a week or longer if documents are rejected and require resubmission.
• Template Approval: Anywhere from 5 minutes to 24 hours per template.
• Sender Display-Name Approval: Usually processed within 24 to 48 hours.
• Overall Recommendation: Expect a realistic one-week window end-to-end to get your channel fully live, driven primarily by Meta’s documentation queue.

9. Troubleshooting & FAQ

• "The number is already registered on WhatsApp" error: This occurs if the line is active on a physical phone running a standard or business WhatsApp app. You must delete the account inside that specific mobile app first, wait a few minutes for the database to clear, and then restart the Twilio integration.
• Meta Business Verification Rejected: Check your account details line-by-line against your documentation. Ensure your registered address doesn't use abbreviations if your official document spells them out in full. Ensure your utility bill or tax record is completely legible, fully uncropped, issued within the last 3 months, and addresses your exact corporate entity name.
• Template Rejected: This is almost always caused by selecting the wrong category (e.g. tagging a message containing booking instructions as 'Authentication') or including conversational, promotional, or subjective phrasing inside a transactional 'Utility' block. Clean up the language to be purely informational and resubmit.
• Display Name Rejected: Ensure you are using your recognizable retail trading name. Remove any experimental web URLs, vague industry descriptors (like writing "Local Pharmacy" instead of your actual business name), or non-standard formatting.
• Messages Suddenly Stop Routing: Check your Twilio Account Balance first. If your corporate card expired or an auto-recharge failed, your messaging capability pauses instantly when credit hits £0. If billing is clear, open your Twilio console to ensure your WhatsApp sender quality rating hasn't been flagged or downgraded due to patient spam reports.

10. After Go-Live: Ongoing Ownership Best Practices

Managing a BYO communications channel requires minimal daily upkeep, but head office should maintain the following structural checks:

• Billing Security: Set up a secondary backup card in your Twilio billing panel to protect your automation line if your primary corporate card is blocked, lost, or reaches its expiration date.
• Quality Monitoring: Routinely check your sender health panel inside your console. High opt-out or block rates from patients will harm your quality score and restrict your daily maximum messaging volume tiers.
• Workflow Adjustments: If you customize or alter your clinical consultation text down the line, remember that any updated notification layout must be approved as a new template first. Remember to send Deltera your new HX... Content SIDs as soon as they drop into an approved state.
• Security Audits: Keep your team's 2FA enforced and run a seasonal audit of who holds user roles inside your Twilio and Meta Business accounts to offboard staff who have changed positions or left the organisation.

‍