{"id":52335,"date":"2025-09-04T09:28:23","date_gmt":"2025-09-04T09:28:23","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=52335"},"modified":"2026-02-21T08:15:54","modified_gmt":"2026-02-21T08:15:54","slug":"whatsapp-cloud-api-direct-integration-with-meta","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/whatsapp-cloud-api-direct-integration-with-meta\/","title":{"rendered":"WhatsApp Cloud API: Direct Integration with Meta"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n

You can do this directly with Meta\u2019s WhatsApp Business Platform (Cloud API)<\/strong> from your own app\/website. Below is a complete, no-BSP, end-to-end checklist you can follow. I\u2019ve included short code samples and the exact places in Meta where each step lives.<\/p>\n\n\n\n

\n\n\n\n

Prerequisites (before you start)<\/h1>\n\n\n\n
    \n
  • A Meta Business<\/strong> account (Business Manager) with admin access.<\/li>\n\n\n\n
  • A Meta Developer<\/strong> account.<\/li>\n\n\n\n
  • A phone number<\/strong> that can receive SMS\/voice for verification (new number is easiest; existing numbers can be onboarded or migrated).<\/li>\n\n\n\n
  • A public HTTPS endpoint<\/strong> for webhooks (e.g., yourdomain.com\/whatsapp\/webhook).<\/li>\n\n\n\n
  • Basic server (Node, PHP, etc.) to store tokens safely<\/strong> and call the Graph API (never call it from the browser). ()<\/li>\n<\/ul>\n\n\n\n
    \n\n\n\n

    Step-by-step setup (Cloud API, hosted by Meta)<\/h1>\n\n\n\n

    1) Create a Meta App & add the WhatsApp product<\/h2>\n\n\n\n
      \n
    1. Go to Meta for Developers \u2192 My Apps \u2192 Create App<\/strong> (choose \u201cBusiness\u201d).<\/li>\n\n\n\n
    2. In your app, Add Product \u2192 WhatsApp<\/strong>.<\/li>\n\n\n\n
    3. Open the WhatsApp<\/strong> product\u2019s Getting Started<\/strong> page.
      This creates the base assets and guides you through initial test-message steps. ()<\/li>\n<\/ol>\n\n\n\n

      2) Create\/confirm your WhatsApp Business Account (WABA)<\/h2>\n\n\n\n
        \n
      • In Business Manager \u2192 Accounts \u2192 WhatsApp Accounts (WhatsApp Manager)<\/strong> you\u2019ll see or create your WABA<\/strong> and manage numbers, templates, metrics, etc. ()<\/li>\n<\/ul>\n\n\n\n

        3) Verify your business in Business Manager (Production requirement)<\/h2>\n\n\n\n
          \n
        • Business Settings \u2192 Security Center \u2192 Start Verification.<\/strong><\/li>\n\n\n\n
        • Submit legal details and documents. Admin privilege is required.
          Business verification unlocks production sending at scale and higher limits. (, )<\/li>\n<\/ul>\n\n\n\n

          4) Request Display Name<\/strong> approval<\/h2>\n\n\n\n
            \n
          • Your WA display name<\/strong> must follow Meta\u2019s rules (no \u201cofficial\u201d, no Meta brands in the name, must reflect your business).<\/li>\n\n\n\n
          • Submit\/approve in WhatsApp Manager<\/strong> when adding the number. ()<\/li>\n<\/ul>\n\n\n\n

            5) Add a phone number (new number) or<\/strong> onboard\/migrate an existing one<\/h2>\n\n\n\n

            A. New number (simplest):<\/strong><\/p>\n\n\n\n

              \n
            • In App Dashboard \u2192 WhatsApp \u2192 Configuration \u2192 Add phone number<\/strong>, verify via SMS\/voice, and you\u2019ll receive a Phone Number ID<\/strong>. (, )<\/li>\n<\/ul>\n\n\n\n

              B. Existing number options:<\/strong><\/p>\n\n\n\n

                \n
              • Embedded Signup<\/strong> supports numbers already used with the WhatsApp Business App<\/strong> (special flow).<\/li>\n\n\n\n
              • Migrate<\/strong> a number from one WABA\/BSP to another with Embedded Signup<\/strong>; you keep display name, quality rating, and limits. (, )<\/li>\n<\/ul>\n\n\n\n
                \n

                You\u2019ll end up with two IDs you\u2019ll use everywhere: your WABA ID<\/strong> and your Phone Number ID<\/strong>. Keep both.<\/p>\n<\/blockquote>\n\n\n\n

                6) Generate a permanent access token<\/strong> (server-side only)<\/h2>\n\n\n\n
                  \n
                • In Business Settings \u2192 Users \u2192 System Users<\/strong>, create a system user, assign your app + WhatsApp permissions, then Generate Token<\/strong>.<\/li>\n\n\n\n
                • Store the token in your backend secrets manager; do not<\/strong> embed in client code. ()<\/li>\n<\/ul>\n\n\n\n

                  7) Set up your Webhook<\/strong> endpoint & subscribe<\/h2>\n\n\n\n
                    \n
                  1. Build an HTTPS endpoint that can respond to the verification handshake<\/strong> with hub.challenge<\/code> when Meta calls it.<\/li>\n\n\n\n
                  2. In App Dashboard \u2192 WhatsApp \u2192 Configuration<\/strong>, add your Callback URL<\/strong> and Verify Token<\/strong> and Verify & Save<\/strong>.<\/li>\n\n\n\n
                  3. Subscribe to message<\/strong> and status<\/strong> events; use the \u201cSend test\u201d button to check delivery to your endpoint. (, , )<\/li>\n<\/ol>\n\n\n\n
                    \n

                    Tip (verification): your endpoint must echo back the hub.challenge<\/code> when it receives the GET verification call. After saving, you\u2019ll start receiving JSON webhooks for inbound messages, delivery\/read receipts, and errors. ()<\/p>\n<\/blockquote>\n\n\n\n

                    8) Create Message Templates<\/strong> (Marketing \/ Utility \/ Authentication)<\/h2>\n\n\n\n
                      \n
                    • Create in WhatsApp Manager<\/strong> or via the Business Management API<\/strong>; wait for approval.<\/li>\n\n\n\n
                    • You\u2019ll reference templates by name<\/strong> (+ language) when sending. (, )<\/li>\n<\/ul>\n\n\n\n

                      9) Understand 2026 pricing<\/strong> & free windows (so your flows are cost-efficient)<\/h2>\n\n\n\n
                        \n
                      • As of July 1, 2026<\/strong>, Meta charges per delivered message<\/strong> for template<\/strong> categories (Marketing, Utility, Authentication) with country-based rate cards<\/strong> and volume tiers<\/strong> (discounts for Utility & Authentication).<\/li>\n\n\n\n
                      • Service<\/strong> replies during the 24-hour customer service window<\/strong> are free; Utility<\/strong> templates sent inside that window are free.<\/li>\n\n\n\n
                      • Free Entry Point (FEP):<\/strong> Messages are free for 72 hours<\/strong> when the user comes from Click-to-WhatsApp Ads<\/strong> or Page CTA<\/strong> and you reply within 24h. (, )<\/li>\n<\/ul>\n\n\n\n

                        10) Send your first message (from your backend)<\/h2>\n\n\n\n

                        cURL (text message)<\/h3>\n\n\n
                        curl -X POST \"https:\/\/graph.facebook.com\/v19.0\/PHONE_NUMBER_ID\/messages\"<\/span> \n  -H \"Authorization: Bearer YOUR_PERMANENT_ACCESS_TOKEN\"<\/span> \n  -H \"Content-Type: application\/json\"<\/span> \n  -d '{\n    \"messaging_product\":\"whatsapp\",\n    \"to\":\"<E164_RECIPIENT>\",\n    \"type\":\"text\",\n    \"text\":{\"body\":\"Hello from the WhatsApp Cloud API!\"}\n  }'<\/span>\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
                        Use \/{PHONE_NUMBER_ID}\/messages<\/code><\/strong>; same endpoint for text, media, interactive, or template sends. ()<\/p>\n\n\n\n
                        \n
                        Prefer testing with Meta\u2019s official Postman collection<\/strong>\u2014it has ready-made calls for send, template, media, etc. ()<\/p>\n<\/blockquote>\n\n\n\n
                        11) Handle delivery, read, and errors (webhooks)<\/h2>\n\n\n\n
                          \n
                        • Update your DB on sent \/ delivered \/ read \/ failed<\/strong>; implement retries with backoff for transient errors (e.g., throughput 130429).<\/li>\n\n\n\n
                        • Keep webhook response times fast<\/strong> (<200 ms) to avoid drops. (, )<\/li>\n<\/ul>\n\n\n\n
                          12) Go from test to production<\/h2>\n\n\n\n
                            \n
                          • After business verification<\/strong>, display name<\/strong> approval, and approved templates<\/strong>, you can send to any opt-in<\/strong> user (not just test recipients).<\/li>\n\n\n\n
                          • Remove test tokens and use the system user<\/strong> token in production. ()<\/li>\n<\/ul>\n\n\n\n
                            \n\n\n\n
                            Compliance & policy must-dos<\/h1>\n\n\n\n
                            Opt-in & content rules<\/h2>\n\n\n\n
                              \n
                            • You must have clear user opt-in<\/strong> (on your site\/app, form, or chat) and follow WhatsApp\u2019s Business Messaging Policy<\/strong>. Store consent (time\/IP\/method).<\/li>\n\n\n\n
                            • Respect the template categories<\/strong> and avoid spammy content; users can block\/report\u2014low quality hurts your limits. ()<\/li>\n<\/ul>\n\n\n\n
                              Rate limits & messaging limits<\/h2>\n\n\n\n
                                \n
                              • Throughput:<\/strong> Cloud API supports ~80 messages\/sec per number<\/strong> by default; eligible accounts auto-upgrade up to 1,000 mps<\/strong>.<\/li>\n\n\n\n
                              • Messaging limits (by phone number):<\/strong> new numbers start low (e.g., 250\/1k), and scale to 10k \u2192 100k \u2192 unlimited<\/strong> based on quality & volume. ()<\/li>\n<\/ul>\n\n\n\n
                                \n\n\n\n
                                Minimal production architecture<\/h1>\n\n\n\n
                                Client (web\/app)<\/strong> \u2192 Your Backend API<\/strong> (stores token, picks template, logs send) \u2192 Meta Graph API (Cloud API)<\/strong>
                                Meta Webhooks<\/strong> \u2192 Your Backend Webhook<\/strong> (updates message status, triggers retries, analytics). ()<\/p>\n\n\n\n
                                Key objects to store<\/strong><\/p>\n\n\n\n
                                  \n
                                • waba_id<\/code>, phone_number_id<\/code>, display_name<\/code>, permanent_access_token<\/code><\/li>\n\n\n\n
                                • Templates (name<\/code>, category<\/code>, language<\/code>, status<\/code>)<\/li>\n\n\n\n
                                • Messages (to<\/code>, template\/text<\/code>, meta_message_id<\/code>, status<\/code>, error_code<\/code>)<\/li>\n<\/ul>\n\n\n\n
                                  \n\n\n\n
                                  Common pitfalls & fixes<\/h1>\n\n\n\n
                                    \n
                                  • Webhook verification fails<\/strong> \u2192 ensure you echo hub.challenge<\/code> exactly and verify token matches the one configured. ()<\/li>\n\n\n\n
                                  • 130429 throughput reached<\/strong> \u2192 you\u2019re sending too fast; throttle below 80 mps or request\/qualify for higher tiers. ()<\/li>\n\n\n\n
                                  • Template rejected<\/strong> \u2192 align with policy; avoid promotional content in Utility\/Auth; include sample variables. ()<\/li>\n\n\n\n
                                  • Display name not showing<\/strong> \u2192 confirm display name approved<\/strong> and number in Connected<\/strong> state in WhatsApp Manager. ()<\/li>\n<\/ul>\n\n\n\n
                                    \n\n\n\n
                                    Optional, money-saving add-ons (direct with Meta)<\/h1>\n\n\n\n
                                      \n
                                    • Click-to-WhatsApp Ads \/ Page CTA<\/strong> to trigger 72-hour free<\/strong> messaging windows (great for onboarding & flows).<\/li>\n\n\n\n
                                    • Use Service + Utility (inside CSW)<\/strong> wherever possible; reserve Marketing<\/strong> for necessary promos. (, )<\/li>\n<\/ul>\n\n\n\n
                                      \n\n\n\n
                                      Quick checklist <\/h2>\n\n\n\n
                                        \n
                                      • Create Meta App<\/strong> & add WhatsApp<\/strong> product. ()<\/li>\n\n\n\n
                                      • Ensure WABA<\/strong> exists in WhatsApp Manager<\/strong>. ()<\/li>\n\n\n\n
                                      • Complete Business Verification<\/strong>. ()<\/li>\n\n\n\n
                                      • Submit Display Name<\/strong> for approval. ()<\/li>\n\n\n\n
                                      • Add\/migrate phone number<\/strong> \u2192 get Phone Number ID<\/strong>. ()<\/li>\n\n\n\n
                                      • Create System User<\/strong> & generate permanent token<\/strong>. ()<\/li>\n\n\n\n
                                      • Build & verify Webhook<\/strong>; subscribe to events. ()<\/li>\n\n\n\n
                                      • Create templates<\/strong> (Marketing\/Utility\/Auth) & get approval. ()<\/li>\n\n\n\n
                                      • Send test message<\/strong> via \/{PHONE_NUMBER_ID}\/messages<\/code>. ()<\/li>\n\n\n\n
                                      • Go live<\/strong> (respect pricing windows & limits). ()<\/li>\n<\/ul>\n\n\n\n
                                        \n\n\n\n
                                        <\/p>\n\n\n\n
                                        <\/p>\n\n\n\n
                                        <\/p>\n\n\n\n
                                        <\/p>\n\n\n\n
                                        Short & clear<\/h3>\n\n\n\n
                                          \n
                                        1. WhatsApp Cloud API: Direct Integration with Meta (2026)<\/li>\n\n\n\n
                                        2. Send WhatsApp Messages Directly via Meta (No BSP)<\/li>\n\n\n\n
                                        3. WhatsApp Business Platform: End-to-End Setup Guide<\/li>\n\n\n\n
                                        4. Meta WhatsApp Cloud API: Step-by-Step for Apps & Websites<\/li>\n\n\n\n
                                        5. WhatsApp Business Messaging: Direct Meta Setup<\/li>\n<\/ol>\n\n\n\n
                                          Step-by-step \/ how-to<\/h3>\n\n\n\n
                                            \n
                                          1. How to Enable WhatsApp Messaging Directly with Meta (Cloud API)<\/li>\n\n\n\n
                                          2. From Zero to Live: WhatsApp Business Cloud API Setup (2026)<\/li>\n\n\n\n
                                          3. Implement WhatsApp Messaging in Your App\u2014No Third-Party Needed<\/li>\n\n\n\n
                                          4. WhatsApp Business Platform Setup: Templates, Webhooks, Tokens & Go-Live<\/li>\n\n\n\n
                                          5. Direct WhatsApp Messaging with Meta: A Complete Developer Guide<\/li>\n<\/ol>\n\n\n\n
                                            Business\/India-focused<\/h3>\n\n\n\n
                                              \n
                                            1. Cheapest Path to WhatsApp Messaging in India: Go Direct with Meta<\/li>\n\n\n\n
                                            2. Scale WhatsApp Messaging for SMBs & Enterprises\u2014Direct with Meta<\/li>\n\n\n\n
                                            3. Meta WhatsApp Cloud API for OTP, Alerts & Marketing (India Guide)<\/li>\n\n\n\n
                                            4. Enterprise-Ready WhatsApp Messaging: Direct Integration Blueprint<\/li>\n\n\n\n
                                            5. WhatsApp Business Messaging Compliance & Setup (No BSP)<\/li>\n<\/ol>\n\n\n\n
                                              Premium\/evergreen<\/h3>\n\n\n\n
                                                \n
                                              1. The Definitive Guide to Meta\u2019s WhatsApp Business Platform (2026)<\/li>\n\n\n\n
                                              2. Production-Ready WhatsApp Cloud API: Architecture, Limits, Pricing<\/li>\n\n\n\n
                                              3. WhatsApp Messaging via Meta: Secure, Scalable, and Cost-Efficient<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"
                                                You can do this directly with Meta\u2019s WhatsApp Business Platform (Cloud API) from your own app\/website. Below is a complete, no-BSP, end-to-end checklist you can follow. I\u2019ve included short code… <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[2],"tags":[],"class_list":["post-52335","post","type-post","status-publish","format-standard","hentry","category-uncategorised"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/52335","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=52335"}],"version-history":[{"count":3,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/52335\/revisions"}],"predecessor-version":[{"id":59577,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/52335\/revisions\/59577"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=52335"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=52335"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=52335"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}