# AiSensy setup for PopMCP You paste the project's API key from AiSensy's Manage screen. Pro-plan projects also hand you a Project ID and an App Password, which unlock the Project API tools. - Auth: API credentials - Setup time: 6 min - API base URL: https://backend.aisensy.com - Credentials screen: https://app.aisensy.com/manage - Provider docs: https://aisensy.stoplight.io/docs/project-api ## Approval required before this works Meta - not AiSensy - must approve the WhatsApp Business Account behind the key: the display name is reviewed, each message template is reviewed, and Facebook Business Manager verification is needed for full access. - Typical wait: AiSensy states "the majority of reviews are completed instantly (within 10 minutes) - only the Display Name can take max. 3-4 hours to get approved." Message templates typically clear in minutes to 24 hours, and Meta Business verification (needed to lift messaging limits) commonly takes 1-5 business days. - Cost: AiSensy's own approval steps are free: it runs a Free Forever plan that includes WhatsApp Business API access and the API key. Paid tiers on aisensy.com/pricing are listed in rupees - about Rs 2,500/month for the chatbot builder tier and Rs 3,500/month for the AI agent tier, cheaper on annual billing. Meta bills separately per conversation. - Blocked until approved: Sending anything. The API key is visible immediately, but the campaign endpoint (POST https://backend.aisensy.com/campaign/t1/api/v2) requires a live API campaign built on an approved template attached to a verified WABA - until the display name and template pass Meta review, calls fail or messages are never delivered. - Works meanwhile: Create the AiSensy account, connect a dedicated phone number not already on WhatsApp, copy the API key from Manage > API Key, draft templates, and wire up the integration code. ## Before you begin - An AiSensy project with a verified WhatsApp Business API number (a live, approved WABA) - At least one approved WhatsApp template message. API campaigns can only send approved templates - A live API campaign, because the Send Campaign tool sends by campaign name - A Pro plan if you want the Project API tools, plus a request to AiSensy support for the Project ID and App Password. Basic plans expose only the API key - Direct API and Partner API access are granted by AiSensy on request. Skip those fields unless AiSensy has enabled them for you ## Get your credentials ### 1. Sign in and switch to the right project Go to app.aisensy.com and sign in. Use the project switcher above the sidebar to select the project holding the WhatsApp number you want PopMCP to use. Screen: https://app.aisensy.com/dashboard ### 2. Launch a live API campaign Open Campaigns, click Launch and choose API Campaign. Pick your approved template, set the campaign live, and copy its name exactly. Screen: https://app.aisensy.com/campaigns ### 3. Copy the credentials from Manage Click Manage in the sidebar, then API Keys. Copy the API Key. On a Pro plan also copy the Project ID and App Password that AiSensy support issued for the project. Screen: https://app.aisensy.com/manage ### 4. Paste the values into PopMCP Put the key in API key. Fill App Password and Project ID only if your project showed them, and leave Business ID, Direct API token, Partner API key and Partner ID empty. ## Fields PopMCP asks for - API key (apiKey) [required]: Dashboard → open your project → Manage → API Key → Generate/Copy. Powers the Send Campaign tool (the key is sent in the request body, no header). Stored encrypted; used server-side only. - App Password (optional) (appPassword): Unlocks the Project API (messaging, contacts, templates, campaigns, webhooks, catalog, media). Sent as the X-AiSensy-Project-API-Pwd header. Set it on the project's API/Manage screen. - Project ID (optional) (projectId): Required alongside the App Password for every Project API tool; it scopes the calls to your project. Find it in the dashboard URL or project settings. - Business ID (optional) (businessId): Only needed for the Get Business Profile project tool. - Direct API token (optional, advanced) (directApiToken): Enables the Direct API (WhatsApp Cloud-API-style messaging, flows, media, WABA, phone numbers, payments). Provide username:password:projectId; we base64-encode it and mint the bearer JWT automatically. Requires Direct API access from AiSensy. - Partner API key (optional, advanced) (partnerApiKey): Enables the Partner/white-label API (manage client projects, billing, plans, WABA onboarding). Sent as the X-AiSensy-Partner-API-Key header. For AiSensy partners only. - Partner ID (optional, advanced) (partnerId): Required alongside the Partner API key for every Partner API tool. ## Verify PopMCP shows AiSensy as Connected, and a test send through your live API campaign delivers a WhatsApp message to the destination number you supply. ## Troubleshooting ### Campaign not found or invalid campaign Cause: The campaign name does not match, or the API campaign was never set live. Fix: Open Campaigns and copy the name exactly as listed, confirming its status is Live. ### Sends fail after working fine Cause: Someone regenerated the project's API key, which invalidates the previous one. Fix: Copy the new key from Manage, API Keys, and reconnect PopMCP. ### No Project ID or App Password on the API Keys screen Cause: The project is on the Basic plan, which exposes only the campaign API key, or the Pro credentials have not been issued yet. Fix: Move the project to Pro, then ask AiSensy support over Live Chat to issue the Project ID and App Password. ### Project API tools return unauthorized Cause: App Password or Project ID missing, mismatched, or belonging to a different project. Fix: Re-copy both from the same project's API Keys screen. They must be supplied as a pair. ### Template rejected on send Cause: The template is not approved by Meta, or the variable count does not match the template body. Fix: Check the template's status under Templates and pass exactly as many parameters as the body defines. --- Source: https://www.docs.popmcp.com/docs/integrations/aisensy/