{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"entry_sha256":"dcd8c57aab0748daac8794056806bf770de25af55dbd6252a3b47d4cc7c29d0d","entry":{"id":"twilio/whatsapp-sender","name":"Twilio WhatsApp sender (Self Sign-up)","vendor":"Twilio","summary":"Register a phone number as a WhatsApp sender through Twilio, using Meta's pop-up to create or pick a Meta Business Portfolio and WhatsApp Business Account. Meta business verification is needed before production scale.","aliases":["twilio-whatsapp","whatsapp-via-twilio"],"category":"messaging","group":"B","homepage":"https://www.twilio.com/en-us/messaging/channels/whatsapp","docs":["https://www.twilio.com/docs/whatsapp/self-sign-up","https://www.twilio.com/docs/whatsapp/tutorial/message-template-approvals-statuses"],"status":"researched","last_verified":null,"last_researched":"2026-10-25","sources":[{"id":"self-sign-up","url":"https://www.twilio.com/docs/whatsapp/self-sign-up","title":"Twilio docs – Register WhatsApp senders with Self Sign-up","accessed":"2026-10-25","supports":"Paid account required; admin access to a Meta Business Portfolio; number requirements; display name rules; step order; one WABA per Twilio account; error 63110; display name rejection limits to 250 business-initiated messages per 24h; Meta business verification free, takes several weeks, unlocks more than two senders and higher limits; registration takes a few minutes","kind":"official"},{"id":"templates","url":"https://www.twilio.com/docs/whatsapp/tutorial/message-template-approvals-statuses","title":"Twilio docs – WhatsApp message template approvals and statuses","accessed":"2026-10-25","supports":"Templates usually approved in minutes, human review up to 48 hours; rejection reasons and fixes; rejected name cannot be reused for 30 days; Paused and Disabled statuses","kind":"official"},{"id":"pricing","url":"https://www.twilio.com/en-us/whatsapp/pricing","title":"Twilio WhatsApp pricing","accessed":"2026-10-25","supports":"Twilio fee $0.005 per message in or out plus Meta template fees passed through; $0.001 failed-message fee; no monthly platform fee","kind":"official"},{"id":"wa-policy","url":"https://whatsappbusiness.com/policy/","title":"WhatsApp Business Messaging Policy","accessed":"2026-10-25","supports":"Opt-in required; outside the 24-hour customer service window only approved templates; prohibited and restricted businesses; Meta may limit or remove access and bar future use","kind":"official"},{"id":"trial","url":"https://www.twilio.com/docs/usage/tutorials/how-to-use-your-free-trial-account","title":"Twilio docs – How to use your free trial account","accessed":"2026-10-25","supports":"Trial uses Twilio templates only; custom WhatsApp templates unavailable on trial","kind":"official"}],"allowed_domains":["twilio.com"],"account_model":{"summary":"The WhatsApp sender is a phone number registered in a WhatsApp Business Account (WABA) that is owned by a Meta Business Portfolio and connected to your Twilio account. One Twilio account can only use one WABA, so every further sender must use the same portfolio and WABA.","accounts":[{"name":"Twilio account (paid)","kind":"organisation","required":true},{"name":"Meta Business Portfolio","kind":"organisation","owned_by":"the company (you need admin access)","required":true,"note":"Can be created inside the sign-up pop-up."},{"name":"WhatsApp Business Account (WABA)","kind":"other","parent":"Meta Business Portfolio","required":true,"note":"Create it during Twilio Self Sign-up; do not reuse a WABA created outside Twilio."},{"name":"WhatsApp sender (phone number)","kind":"other","parent":"WhatsApp Business Account (WABA)","required":true}]},"prerequisites":[{"entry":"twilio/account-and-keys","note":"The Twilio account must be upgraded from trial."},{"entry":"meta/whatsapp","note":"Background on WhatsApp Business rules and Meta business verification."},{"need":"A Facebook login with admin rights on (or able to create) a Meta Business Portfolio"}],"have_ready":[{"kind":"other","description":"A phone number not currently registered on WhatsApp (Twilio or your own) that can receive an SMS or voice code","why":"Numbers already on WhatsApp fail (error 63110); IVR or outbound-only numbers cannot receive the code.","needed_for":["pick-number","verify-number"],"auto_check":"none","source":"self-sign-up"},{"kind":"other","description":"A display name that follows Meta's display name guidelines and matches your brand","why":"A rejected display name limits the number to 250 business-initiated messages per 24 hours and may lead Meta to disconnect it.","needed_for":["business-profile"],"auto_check":"none","source":"self-sign-up"},{"kind":"company_documents","description":"Legal business documents for Meta business verification","why":"Unverified portfolios cannot move to production scale or add more than two senders. Document list is set by Meta (see the meta entries).","needed_for":["meta-business-verification"],"auto_check":"none","source":"self-sign-up"},{"kind":"live_website","description":"A live business website matching the business name","why":"Used in the business profile and Meta business verification. [to verify for Twilio flow]","needed_for":["meta-business-verification"],"auto_check":"website_live"}],"steps":[{"id":"account","title":"Use an upgraded Twilio account","summary":"Sign in to Twilio; the account must be paid, not trial.","route":"guided","depends_on":[],"gate":"human_login","sources":["self-sign-up"]},{"id":"pick-number","title":"Start a new WhatsApp sender","summary":"In Console go to Messaging > Senders > WhatsApp Senders > Create new sender and choose the number.","route":"copilot","depends_on":["account"],"gate":"none","url":"https://console.twilio.com/","sources":["self-sign-up"]},{"id":"meta-pop-up","title":"Continue with Facebook","summary":"Click Continue with Facebook and log in yourself. Approve permissions, create or pick the Meta Business Portfolio and WABA, and enter the account name, display name and category. Keep both windows open in the same browser and never share the pop-up URL.","route":"guided","depends_on":["pick-number"],"gate":"human_terms","sources":["self-sign-up"]},{"id":"business-profile","title":"Set the WhatsApp Business profile","summary":"Enter the customer-facing display name and category in the pop-up. Do not choose \"Use a display name only\" (a 555 number Twilio does not support).","route":"guided","depends_on":["meta-pop-up"],"gate":"human_submit","preflight":["display_name_matches_business"],"recovery":[{"hiccup":"Meta rejects the display name","fix":"Edit the sender in the Twilio Console and change the profile name to one that meets Meta's guidelines.","source":"self-sign-up"}],"sources":["self-sign-up"]},{"id":"verify-number","title":"Verify the number with a code","summary":"Enter the one-time code. Twilio SMS numbers show it in the Console; Twilio voice-only numbers need the Voicemail Twimlet so the code arrives by email (up to 10 minutes); other numbers get it by SMS or call.","route":"guided","depends_on":["business-profile"],"gate":"2fa","lead_time":{"official":{"text":"Registration completes a few minutes after you confirm; voice code emails can take up to 10 minutes.","source":"self-sign-up"}},"recovery":[{"hiccup":"Number already registered with WhatsApp","code":"63110","fix":"Delete the WhatsApp or WhatsApp Business app account on that number, or turn off 2FA at the other provider, then retry.","source":"self-sign-up"},{"hiccup":"Second sender fails to register","fix":"Use the same Meta Business Portfolio and WABA as the first sender; one Twilio account cannot use several WABAs.","source":"self-sign-up"}],"sources":["self-sign-up"]},{"id":"confirm-access","title":"Approve Twilio's access request","summary":"Review and confirm the access request so Twilio can send for your WABA.","route":"guided","depends_on":["verify-number"],"gate":"human_submit","sources":["self-sign-up"]},{"id":"meta-business-verification","title":"Complete Meta business verification","summary":"If the portfolio is new or unverified, verify it in Meta Security Center before production. It is free (not the Meta Verified subscription) and unlocks higher limits and more than two senders.","route":"guided","depends_on":["confirm-access"],"gate":"third_party_review","lead_time":{"official":{"text":"Twilio says Meta business verification can take several weeks depending on region; start early.","source":"self-sign-up"}},"sources":["self-sign-up"]},{"id":"templates","title":"Create and submit message templates","summary":"Create templates in the Content Template Builder; choose the category explicitly (Content Editor or API) so Meta does not override it.","route":"guided","depends_on":["confirm-access"],"gate":"third_party_review","lead_time":{"official":{"text":"Usually approved within minutes; templates needing human review can take up to 48 hours.","source":"templates"}},"recovery":[{"hiccup":"Template rejected (for example INVALID_FORMAT or TAG_CONTENT_MISMATCH)","fix":"Read the rejection code, fix placeholders, language or category, and resubmit under a new name; a rejected name cannot be reused for 30 days.","source":"templates"},{"hiccup":"Template pending for more than 48 hours","fix":"Open a Twilio support ticket with the template name.","source":"templates"}],"sources":["templates"]}],"outputs":[{"name":"TWILIO_WHATSAPP_FROM","description":"WhatsApp sender address used as From","secret":false,"example_format":"whatsapp:+<E.164 number>","from_step":"verify-number"}],"terms_notes":[{"kind":"rules_say","severity":"red","text":"Meta may limit or remove your access to WhatsApp for Business for policy breaches or negative user feedback, and may bar you and your organisation from future use.","source":"wa-policy"},{"kind":"rules_say","severity":"red","text":"You may only message people who gave you their number and agreed to receive messages, and you must honour opt-outs.","source":"wa-policy"},{"kind":"rules_say","severity":"amber","text":"Outside the 24-hour customer service window you may only send approved templates; Meta's per-template fees are passed through on top of Twilio's per-message fee.","source":"pricing"},{"kind":"rules_say","severity":"amber","text":"A rejected display name caps the number at 250 business-initiated messages per 24 hours and Meta may disconnect the sender.","source":"self-sign-up"},{"kind":"rules_say","severity":"yellow","text":"Templates with repeated negative feedback are Paused, and can be Disabled for repeated feedback or policy breaches.","source":"templates"}],"pricing_notes":{"costs":"Twilio $0.005 per WhatsApp message (inbound or outbound) plus Meta template fees; $0.001 per failed message.","notes":"No monthly platform fee listed; Meta rates vary by country and template category.","source":"pricing"},"stripe_projects":false,"api_provisioning":{"available":"partial","notes":"Number verification and Meta consent happen in Meta's pop-up and must be done by a person; templates can be managed through the Content API.","source":"self-sign-up"},"detect":{"env_names":["TWILIO_WHATSAPP_FROM","TWILIO_WHATSAPP_NUMBER"],"packages":["twilio"]}}}