Connect WhatsApp Business numbers to Thoughtly so the same omnichannel agent can handle WhatsApp conversations alongside voice, SMS, and email channels.
WhatsApp Business lets Thoughtly agents send and receive WhatsApp messages through connected business numbers. Use it for mobile-first conversations, international follow-up, appointment reminders, and ongoing customer engagement.
WhatsApp has strict messaging rules. Outside the customer-service window, outbound messages generally require approved message templates. Make sure your workflow follows WhatsApp and local messaging rules.
Prerequisites
Before connecting WhatsApp, make sure you have:
A WhatsApp Business account
A business portfolio or Meta Business setup where required
A phone number eligible for WhatsApp Business messaging
Any required approved message templates for outbound outreach
Admin access in Thoughtly
Connect WhatsApp
Go to the WhatsApp or Channels page in Thoughtly.
Choose Connect WhatsApp Business.
Follow the authorization flow for your WhatsApp Business account.
Select or import the phone numbers you want to use.
Assign each number to the appropriate Thoughtly agent.
After a number is connected, incoming WhatsApp messages can be routed to the linked agent where supported.
24-hour customer-service window
WhatsApp allows businesses to send freeform replies within the customer-service window after a user messages the business. Outside that window, outbound messages generally need to use approved templates.
Message type
When to use
Freeform message
Responding within the active customer-service window
Template message
Starting or re-opening a conversation outside the window
Automation actions
Depending on your workspace configuration, WhatsApp actions may include:
Start WhatsApp Conversation — start or continue a conversation with a selected agent and WhatsApp number.
Send WhatsApp Message — send a freeform message when allowed.
Send WhatsApp Template — send an approved template with variables.
Template variables
When sending a template, map Thoughtly variables into the template fields. For example:
Hi {{ contact.first_name }}, this is a reminder for your appointment on {{ appointment.date }}.
Use the data picker to insert fields from triggers, previous steps, contact attributes, or agent variables.
Troubleshooting
Message appears sent but later fails
WhatsApp and messaging providers may accept a request first and send a failure webhook later. Check the run logs, History, or message status to see the final delivery result.
Template is rejected
Confirm the template is approved in WhatsApp Manager and that all required variables are provided.
Contact does not receive freeform messages
The customer-service window may have expired. Use an approved template to re-open the conversation.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Thoughtly Docs","colors":{"primary":"#32CB08","light":"#72FA4C","dark":"#424242"},"logo":{"light":"https://mintcdn.com/thoughtly/SDuN6oJ1BG6zNAlA/images/logo/light.svg?fit=max\u0026auto=format\u0026n=SDuN6oJ1BG6zNAlA\u0026q=85\u0026s=4d3354db16ce0ed2172d34e5e8035572","dark":"https://mintcdn.com/thoughtly/SDuN6oJ1BG6zNAlA/images/logo/dark.svg?fit=max\u0026auto=format\u0026n=SDuN6oJ1BG6zNAlA\u0026q=85\u0026s=58a7238c8201f8aeffddfdc60c80dd8c"},"favicon":"https://mintcdn.com/thoughtly/SDuN6oJ1BG6zNAlA/images/logo/icon.svg?fit=max\u0026auto=format\u0026n=SDuN6oJ1BG6zNAlA\u0026q=85\u0026s=d50cd38bf5f4eb0a9448d1f0a514e9ff","api":{"openapi":"api-reference/openapi.json","mdx":{"server":"https://api.thoughtly.com"}},"navbar":{"links":[{"href":"https://docs.thoughtly.com/support/changelog","label":"Changelog"}],"primary":{"type":"button","label":"Get Started","href":"https://thought.ly/demo"}},"footer":{"socials":{"x":"https://twitter.com/thoughtlyai","linkedin":"https://www.linkedin.com/company/thoughtly-ai","instagram":"https://www.instagram.com/thoughtly.ai","slack":"https://community.thoughtly.com"}},"seo":{"metatags":{"og:type":"website","og:site_name":"Thoughtly Docs"},"indexing":"all"},"integrations":{"ga4":{"measurementId":"G-4JRQ329JCS"},"intercom":{"appId":"uii3kkuk"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Book a Demo","icon":"calendar","href":"https://thoughtly.com/demo"},{"anchor":"Platform Status","icon":"server","href":"https://status.thoughtly.com"},{"anchor":"Contact Support","icon":"life-ring","href":"mailto:support@thoughtly.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"thoughtly","hasAudioNarration":false,"actualSubdomain":"thoughtly","customDomains":["docs.thoughtly.com"],"gitSource":{"type":"github","owner":"thoughtlead-io","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ac7f6a1ac9242b21d007cf3","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Documentation","count":92},{"language":"default","tag":"Promptbooks","count":50},{"language":"default","tag":"Integrations","count":31},{"language":"default","tag":"Resources","count":28},{"language":"default","tag":"Native Integrations","count":23},{"language":"default","tag":"Glossary","count":21},{"language":"default","tag":"Agents","count":17},{"language":"default","tag":"Platform","count":17},{"language":"default","tag":"API Reference","count":13},{"language":"default","tag":"Settings","count":10}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@thoughtly.com","showHelpButton":true}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"starterQuestions":[{"_id":"690511b615e3c149686814cd","deploymentId":"6655d61f74c547ce373fda02","questionText":"How do I trigger an Automation using the API?","status":"active","generatedBy":"manual","createdAt":"2025-10-31T19:44:54.939Z","updatedAt":"2025-10-31T19:44:54.939Z","__v":0},{"_id":"690511ac15e3c14968681344","deploymentId":"6655d61f74c547ce373fda02","questionText":"What mid-call actions are available?","status":"active","generatedBy":"manual","createdAt":"2025-10-31T19:44:44.849Z","updatedAt":"2025-10-31T19:44:44.849Z","__v":0},{"_id":"690511a115e3c149686810f2","deploymentId":"6655d61f74c547ce373fda02","questionText":"How do I integrate Thoughtly with Salesforce?","status":"active","generatedBy":"manual","createdAt":"2025-10-31T19:44:33.341Z","updatedAt":"2025-10-31T19:44:33.341Z","__v":0}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#promptbookGrid{display:grid;grid-template-columns:1fr;gap:1.5rem;padding-top:2rem;padding-bottom:2rem}:root{--docs-image-radius: clamp(8px, 1vw + 4px, 12px)}.mdx-content img:not([src$=\".svg\"i]):not(.no-radius),img[src^=\"/images/\"]:not([src$=\".svg\"i]):not(.no-radius){border-radius:var(--docs-image-radius)!important}.mdx-content img.radius-sm{border-radius:6px}.mdx-content img.radius-lg{border-radius:16px}@media (min-width: 640px){#promptbookGrid{grid-template-columns:repeat(2, 1fr)}}@media (min-width: 768px){#promptbookGrid{grid-template-columns:repeat(3, 1fr)}}@media (min-width: 1024px){#promptbookGrid{grid-template-columns:repeat(4, 1fr)}}.responsive-promptbook-heading{display:flex;flex-direction:column;gap:1rem;align-items:flex-start;justify-content:flex-start;margin-top:1rem;margin-bottom:1rem}@media (min-width: 768px){.responsive-promptbook-heading{flex-direction:row;align-items:center;justify-content:space-between}}.promptbook-card{box-shadow:0 0 10px rgba(0, 0, 0, 0.05)}.promptbook-card:hover{box-shadow:0 0 10px rgba(0, 0, 0, 0.2);scale:1.01;transition:all 0.3s ease}.promptbook-content{font-family:system-ui, sans-serif;color:#1f2937;line-height:1.7;max-width:100%;padding-bottom:2rem}.promptbook-content h1,.promptbook-content h2,.promptbook-content h3,.promptbook-content h4,.promptbook-content h5,.promptbook-content h6{font-weight:600;color:#111827;margin-top:2rem;margin-bottom:1rem;line-height:1.25}.promptbook-content h1{font-size:2rem}.promptbook-content h2{font-size:1.5rem}.promptbook-content h3{font-size:1.25rem}.promptbook-content h4{font-size:1.1rem}.promptbook-content h5{font-size:1rem}.promptbook-content h6{font-size:0.95rem}.promptbook-content p{margin-top:1rem;margin-bottom:1rem}.promptbook-content strong{font-weight:600}.promptbook-content em{font-style:italic}.promptbook-content a{color:#32CB08;text-decoration:underline;transition:color 0.2s ease-in-out}.promptbook-content a:hover{color:#26a005}.promptbook-content ul,.promptbook-content ol{margin-top:1rem;margin-bottom:1rem;padding-left:1.5rem}.promptbook-content ul li::marker{color:#32CB08}.promptbook-content blockquote{border-left:4px solid #32CB08;padding-left:1rem;color:#6b7280;font-style:italic;margin:1.5rem 0}.promptbook-content pre{background-color:#f9fafb;color:#111827;padding:1rem;border-radius:6px;overflow-x:auto;margin:1.5rem 0}.promptbook-content code{background-color:#f3f4f6;padding:0.2rem 0.4rem;border-radius:4px;font-size:0.9em;font-family:monospace}.promptbook-content hr{border:none;border-top:1px solid #e5e7eb;margin:2rem 0}"}],"page":{"pagePath":"integrations/communication/whatsapp-business","slug":"/integrations/communication/whatsapp-business","pageMetadata":{"title":"WhatsApp Business","description":"Connect WhatsApp Business numbers to Thoughtly so the same omnichannel agent can handle WhatsApp conversations alongside voice, SMS, and email channels.","href":"/integrations/communication/whatsapp-business"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect WhatsApp Business numbers to Thoughtly so the same omnichannel agent can handle WhatsApp conversations alongside voice, SMS, and email channels.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`WhatsApp Business lets Thoughtly agents send and receive WhatsApp messages through connected business numbers. Use it for mobile-first conversations, international follow-up, appointment reminders, and ongoing customer engagement.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`WhatsApp has strict messaging rules. Outside the customer-service window, outbound messages generally require approved message templates. Make sure your workflow follows WhatsApp and local messaging rules.`})}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsx(_components.p,{children:`Before connecting WhatsApp, make sure you have:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A WhatsApp Business account`}),`\n`,_jsx(_components.li,{children:`A business portfolio or Meta Business setup where required`}),`\n`,_jsx(_components.li,{children:`A phone number eligible for WhatsApp Business messaging`}),`\n`,_jsx(_components.li,{children:`Any required approved message templates for outbound outreach`}),`\n`,_jsx(_components.li,{children:`Admin access in Thoughtly`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`connect-whatsapp`,children:`Connect WhatsApp`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Go to the WhatsApp or Channels page in Thoughtly.`}),`\n`,_jsxs(_components.li,{children:[`Choose `,_jsx(_components.strong,{children:`Connect WhatsApp Business`}),`.`]}),`\n`,_jsx(_components.li,{children:`Follow the authorization flow for your WhatsApp Business account.`}),`\n`,_jsx(_components.li,{children:`Select or import the phone numbers you want to use.`}),`\n`,_jsx(_components.li,{children:`Assign each number to the appropriate Thoughtly agent.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`After a number is connected, incoming WhatsApp messages can be routed to the linked agent where supported.`}),`\n`,_jsx(Heading,{level:`2`,id:`24-hour-customer-service-window`,children:`24-hour customer-service window`}),`\n`,_jsx(_components.p,{children:`WhatsApp allows businesses to send freeform replies within the customer-service window after a user messages the business. Outside that window, outbound messages generally need to use approved templates.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Message type`}),_jsx(_components.th,{children:`When to use`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Freeform message`}),_jsx(_components.td,{children:`Responding within the active customer-service window`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Template message`}),_jsx(_components.td,{children:`Starting or re-opening a conversation outside the window`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`automation-actions`,children:`Automation actions`}),`\n`,_jsx(_components.p,{children:`Depending on your workspace configuration, WhatsApp actions may include:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Start WhatsApp Conversation`}),` — start or continue a conversation with a selected agent and WhatsApp number.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Send WhatsApp Message`}),` — send a freeform message when allowed.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Send WhatsApp Template`}),` — send an approved template with variables.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`template-variables`,children:`Template variables`}),`\n`,_jsx(_components.p,{children:`When sending a template, map Thoughtly variables into the template fields. For example:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Hi {{ contact.first_name }}, this is a reminder for your appointment on {{ appointment.date }}.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Use the data picker to insert fields from triggers, previous steps, contact attributes, or agent variables.`}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsx(Heading,{level:`3`,id:`message-appears-sent-but-later-fails`,children:`Message appears sent but later fails`}),`\n`,_jsx(_components.p,{children:`WhatsApp and messaging providers may accept a request first and send a failure webhook later. Check the run logs, History, or message status to see the final delivery result.`}),`\n`,_jsx(Heading,{level:`3`,id:`template-is-rejected`,children:`Template is rejected`}),`\n`,_jsx(_components.p,{children:`Confirm the template is approved in WhatsApp Manager and that all required variables are provided.`}),`\n`,_jsx(Heading,{level:`3`,id:`contact-does-not-receive-freeform-messages`,children:`Contact does not receive freeform messages`}),`\n`,_jsx(_components.p,{children:`The customer-service window may have expired. Use an approved template to re-open the conversation.`}),`\n`,_jsx(Heading,{level:`2`,id:`see-also`,children:`See also`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/platform/omnichannel`,children:`Omnichannel agents`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/platform/settings/audiences`,children:`Consent and suppression`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/automations/actions`,children:`Automations actions`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"WhatsApp Business","description":"Connect WhatsApp Business numbers to Thoughtly so the same omnichannel agent can handle WhatsApp conversations alongside voice, SMS, and email channels.","href":"/integrations/communication/whatsapp-business"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Connect WhatsApp","slug":"connect-whatsapp","depth":2,"children":[]},{"title":"24-hour customer-service window","slug":"24-hour-customer-service-window","depth":2,"children":[]},{"title":"Automation actions","slug":"automation-actions","depth":2,"children":[]},{"title":"Template variables","slug":"template-variables","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[{"title":"Message appears sent but later fails","slug":"message-appears-sent-but-later-fails","depth":3,"children":[]},{"title":"Template is rejected","slug":"template-is-rejected","depth":3,"children":[]},{"title":"Contact does not receive freeform messages","slug":"contact-does-not-receive-freeform-messages","depth":3,"children":[]}]},{"title":"See also","slug":"see-also","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/thoughtly/79fc8fef0e90a20d/content/promptbook-scripts.js"],"subdomain":"thoughtly","siteName":"Thoughtly Docs","title":"WhatsApp Business - Thoughtly Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-22T13:29:49.651Z","originalFileLocation":"integrations/communication/whatsapp-business.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect WhatsApp Business numbers to Thoughtly so the same omnichannel agent can handle WhatsApp conversations alongside voice, SMS, and email channels.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Thoughtly Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/thoughtly/weHpxQJRTR6-Xzn6/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/thoughtly/weHpxQJRTR6-Xzn6/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/thoughtly/weHpxQJRTR6-Xzn6/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/thoughtly/weHpxQJRTR6-Xzn6/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/thoughtly/weHpxQJRTR6-Xzn6/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/thoughtly/weHpxQJRTR6-Xzn6/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/thoughtly/weHpxQJRTR6-Xzn6/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/thoughtly/weHpxQJRTR6-Xzn6/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/thoughtly/weHpxQJRTR6-Xzn6/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"WhatsApp Business - Thoughtly Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect WhatsApp Business numbers to Thoughtly so the same omnichannel agent can handle WhatsApp conversations alongside voice, SMS, and email channels.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Thoughtly Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.thoughtly.com/integrations/communication/whatsapp-business\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://thoughtly.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=WhatsApp+Business\u0026amp;description=Connect+WhatsApp+Business+numbers+to+Thoughtly+so+the+same+omnichannel+agent+can+handle+WhatsApp+conversations+alongside+voice%2C+SMS%2C+and+email+channels.\u0026amp;theme=e6e8ef15773ebca659285773\u0026amp;signature=2638b788e62e9b5eb39e897f9fe49d1d0904719e3117329949453fe4eb841a21\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"WhatsApp Business - Thoughtly Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect WhatsApp Business numbers to Thoughtly so the same omnichannel agent can handle WhatsApp conversations alongside voice, SMS, and email channels.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://thoughtly.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=WhatsApp+Business\u0026amp;description=Connect+WhatsApp+Business+numbers+to+Thoughtly+so+the+same+omnichannel+agent+can+handle+WhatsApp+conversations+alongside+voice%2C+SMS%2C+and+email+channels.\u0026amp;theme=e6e8ef15773ebca659285773\u0026amp;signature=2638b788e62e9b5eb39e897f9fe49d1d0904719e3117329949453fe4eb841a21\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/thoughtly/weHpxQJRTR6-Xzn6/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Thoughtly Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#32CB08\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.thoughtly.com/integrations/communication/whatsapp-business\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/integrations/communication/whatsapp-business.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.thoughtly.com/#organization\",\"name\":\"Thoughtly Docs\",\"url\":\"https://docs.thoughtly.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/thoughtly/SDuN6oJ1BG6zNAlA/images/logo/light.svg?fit=max\u0026auto=format\u0026n=SDuN6oJ1BG6zNAlA\u0026q=85\u0026s=4d3354db16ce0ed2172d34e5e8035572\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.thoughtly.com#website\",\"name\":\"Thoughtly Docs\",\"url\":\"https://docs.thoughtly.com\",\"publisher\":{\"@id\":\"https://docs.thoughtly.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.thoughtly.com/integrations/communication/whatsapp-business#webpage\",\"url\":\"https://docs.thoughtly.com/integrations/communication/whatsapp-business\",\"name\":\"WhatsApp Business\",\"description\":\"Connect WhatsApp Business numbers to Thoughtly so the same omnichannel agent can handle WhatsApp conversations alongside voice, SMS, and email channels.\",\"dateModified\":\"2026-05-22T13:29:49.651Z\",\"isPartOf\":{\"@id\":\"https://docs.thoughtly.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.thoughtly.com/integrations/communication/whatsapp-business#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.thoughtly.com/integrations/communication/whatsapp-business#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tools\",\"item\":\"https://docs.thoughtly.com/genius/getting-started\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Integrations\",\"item\":\"https://docs.thoughtly.com/integrations/getting-started\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"WhatsApp Business\",\"item\":\"https://docs.thoughtly.com/integrations/communication/whatsapp-business\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.thoughtly.com/integrations/communication/whatsapp-business#article\",\"headline\":\"WhatsApp Business\",\"name\":\"WhatsApp Business\",\"description\":\"Connect WhatsApp Business numbers to Thoughtly so the same omnichannel agent can handle WhatsApp conversations alongside voice, SMS, and email channels.\",\"url\":\"https://docs.thoughtly.com/integrations/communication/whatsapp-business\",\"mainEntityOfPage\":{\"@id\":\"https://docs.thoughtly.com/integrations/communication/whatsapp-business#webpage\"},\"dateModified\":\"2026-05-22T13:29:49.651Z\",\"publisher\":{\"@id\":\"https://docs.thoughtly.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.thoughtly.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Thoughtly Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Thoughtly Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/integrations/communication/whatsapp-business.md","siteName":"Thoughtly Docs","nav":{"global":{"anchors":[{"anchor":"Book a Demo","icon":"calendar","href":"https://thoughtly.com/demo"},{"anchor":"Platform Status","icon":"server","href":"https://status.thoughtly.com"},{"anchor":"Contact Support","icon":"life-ring","href":"mailto:support@thoughtly.com"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","icon":{"style":"light","name":"rocket"},"pages":[{"title":"Introduction to Thoughtly","href":"/getting-started/introduction"},{"title":"Quick start guide","href":"/getting-started/quick-start"},{"title":"Voice agent use cases and examples","href":"/getting-started/use-cases"},{"title":"Developer documentation","href":"/developers"}]},{"group":"Agents","icon":{"style":"light","name":"diagram-nested"},"pages":[{"title":"Agent Builder overview","href":"/agents/overview"},{"group":"Building","pages":[{"title":"Node types in the Agent Builder","href":"/agents/nodes"},{"title":"Outcomes and conversation branching","href":"/agents/outcomes"},{"title":"Variables in voice agents","href":"/agents/variables"},{"title":"Actions","href":"/agents/actions"},{"title":"Agent settings","href":"/agents/settings"},{"title":"Vibes AI assistant","href":"/agents/vibes-assistant"}]},{"group":"Voices","pages":[{"title":"Agent voices","href":"/agents/voices"},{"title":"Voice optimization for natural speech","href":"/agents/voice-optimization"},{"title":"Bring Your Own Key (BYOK) for voices","href":"/agents/voice-byok"},{"title":"Voice cloning for agents","href":"/agents/voice-cloning"}]},{"group":"Launch","pages":[{"title":"Test voice agents before launch","href":"/agents/testing"},{"title":"Voice agent tips and tricks","href":"/agents/tips-and-tricks"},{"title":"Deploy a voice agent","href":"/agents/deployment"}]},{"group":"Reference","pages":[{"title":"Troubleshoot Thoughtly voice agents","href":"/agents/troubleshooting"},{"title":"Call screening bypass","href":"/agents/call-screening-bypass"},{"title":"Migrate legacy agents to v1.8 Agent Builder","href":"/agents/migration-guide"}]}]},{"group":"Audiences","icon":{"style":"light","name":"users"},"pages":[{"title":"Audiences and contact management","href":"/platform/audiences"}]},{"group":"History","icon":{"style":"light","name":"clock-rotate-left"},"pages":[{"title":"Call and conversation history","href":"/platform/history"}]},{"group":"Tools","icon":{"style":"light","name":"toolbox"},"pages":[{"group":"Genius","pages":[{"title":"Get started with Genius knowledge bases","href":"/genius/getting-started"},{"title":"Data sources for Genius","href":"/genius/sources"},{"title":"Genius knowledge base best practices","href":"/genius/best-practices"},{"title":"Bind Genius knowledge to agents","href":"/genius/agent-binding"},{"title":"Troubleshoot Genius knowledge bases","href":"/genius/troubleshooting"}]},{"group":"Automations","pages":[{"title":"Get started with Thoughtly automations","href":"/automations/getting-started"},{"title":"Automation triggers","href":"/automations/triggers"},{"title":"Automation actions and steps","href":"/automations/actions"},{"title":"Attributes vs metadata in automations","href":"/automations/attributes-vs-metadata"},{"title":"Troubleshoot Thoughtly automations","href":"/automations/troubleshooting"}]},{"group":"Integrations","pages":[{"title":"Get started with Thoughtly integrations","href":"/integrations/getting-started"},{"title":"Webhooks configuration","href":"/integrations/webhooks"},{"title":"Troubleshoot Thoughtly integrations","description":"Diagnose and resolve common Thoughtly integration issues, including OAuth failures, missing data, mapping errors, and CRM sync problems across connected apps.","href":"/integrations/troubleshooting"},{"title":"WhatsApp Business","href":"/integrations/communication/whatsapp-business"},{"title":"iMessage / Linq","description":"Route supported iMessage messaging numbers through Linq to Thoughtly agents so the same omnichannel agent can handle text-based conversations alongside other channels.","href":"/integrations/communication/imessage-linq"},{"title":"CRM sync","href":"/integrations/crm/crm-sync"},{"title":"Code","href":"/integrations/developer/code"},{"title":"MCP Server","href":"/integrations/developer/mcp"}]}]},{"group":"Platform","icon":{"style":"light","name":"sliders"},"pages":[{"title":"Platform overview","href":"/platform/overview"},{"title":"Omnichannel agents","href":"/platform/omnichannel"},{"title":"Workspace switcher","href":"/platform/workspace-switcher"},{"title":"User menu","href":"/platform/user-menu"},{"group":"Workspaces","pages":[{"title":"Workspaces and team collaboration","href":"/platform/teams/overview"}]},{"title":"Billing on Thoughtly","href":"/platform/billing"},{"title":"Analytics in Thoughtly","href":"/platform/analytics"},{"group":"Settings","pages":[{"title":"General workspace settings","href":"/platform/settings/general"},{"title":"Audiences settings","href":"/platform/settings/audiences"},{"title":"Dark windows and quiet hours","href":"/platform/settings/dark-windows"},{"title":"Phone numbers settings","href":"/platform/settings/phone-numbers"},{"title":"Voices settings","href":"/platform/settings/voices"},{"title":"Usage and credit consumption","href":"/platform/settings/usage"},{"title":"Subscription and plan","href":"/platform/settings/subscription"},{"title":"Developer settings","href":"/platform/settings/developer"},{"title":"Email domains","href":"/platform/settings/email-domains"},{"title":"Audit log","href":"/platform/settings/audit-log"}]}]},{"group":"Phone Numbers","icon":{"style":"light","name":"phone"},"pages":[{"title":"Get started with phone numbers","href":"/phone-number/getting-started"},{"title":"Bring Your Own Carrier (BYOC)","href":"/phone-number/byoc"},{"title":"Phone number configuration and assignment","href":"/phone-number/configuration"},{"title":"Branded calling for outbound numbers","href":"/phone-number/branded-calling"},{"title":"Phone number billing and credits","href":"/phone-number/billing-credits"},{"title":"Troubleshoot phone numbers","href":"/phone-number/troubleshooting"}]},{"group":"Genius","icon":{"style":"light","name":"brain"},"pages":[{"title":"Get started with Genius knowledge bases","href":"/genius/getting-started"},{"title":"Data sources for Genius","href":"/genius/sources"},{"title":"Genius knowledge base best practices","href":"/genius/best-practices"},{"title":"Bind Genius knowledge to agents","href":"/genius/agent-binding"},{"title":"Troubleshoot Genius knowledge bases","href":"/genius/troubleshooting"}]},{"group":"Automations","icon":{"style":"light","name":"code-branch"},"pages":[{"title":"Get started with Thoughtly automations","href":"/automations/getting-started"},{"title":"Automation triggers","href":"/automations/triggers"},{"title":"Automation actions and steps","href":"/automations/actions"},{"title":"Attributes vs metadata in automations","href":"/automations/attributes-vs-metadata"},{"title":"Troubleshoot Thoughtly automations","href":"/automations/troubleshooting"}]},{"group":"Resources","icon":{"style":"light","name":"graduation-cap"},"pages":[{"title":"Thoughtly FAQ","href":"/resources/faq"},{"title":"Video library","href":"/resources/video-library"},{"group":"Glossary","pages":[{"title":"Glossary","href":"/resources/glossary/overview"},{"title":"Voice agent","href":"/resources/glossary/voice-agent"},{"title":"Large language model (LLM)","href":"/resources/glossary/large-language-model"},{"title":"TTS (text-to-speech)","href":"/resources/glossary/tts"},{"title":"STT (speech-to-text)","href":"/resources/glossary/stt"},{"title":"Decision tree","href":"/resources/glossary/decision-tree"},{"title":"Happy path","href":"/resources/glossary/happy-path"},{"title":"RAG (retrieval-augmented generation)","href":"/resources/glossary/rag"},{"title":"Screen pop","href":"/resources/glossary/screen-pop"},{"title":"Carrier","href":"/resources/glossary/carrier"},{"title":"CRM","href":"/resources/glossary/crm"},{"title":"Workflow","href":"/resources/glossary/workflow"},{"title":"Variable","href":"/resources/glossary/variable"},{"title":"Transcript","href":"/resources/glossary/transcript"},{"title":"PII (personally identifiable information)","href":"/resources/glossary/pii"},{"title":"Dead end","href":"/resources/glossary/dead-end"},{"title":"OAuth","href":"/resources/glossary/oauth"},{"title":"Twilio","href":"/resources/glossary/twilio"},{"title":"Telnyx","href":"/resources/glossary/telnyx"},{"title":"Hallucination","href":"/resources/glossary/hallucination"},{"title":"AI voice","href":"/resources/glossary/ai-voice"}]},{"title":"Voice agent scheduling guide","href":"/resources/agent-scheduling"},{"title":"Call tagged contacts with an automation","href":"/resources/outbound-automation-tagged-contacts"},{"group":"Whitepapers","pages":[{"title":"Thoughtly whitepapers","href":"/resources/whitepapers/overview"},{"title":"Breaking free from intent-based dialog design","href":"/resources/whitepapers/conversational-ai"},{"title":"So you want to start an AI agency?","href":"/resources/whitepapers/agency-guide"}]}]},{"group":"Support","icon":{"style":"light","name":"life-ring"},"pages":[{"title":"Get support from Thoughtly","href":"/support/getting-help"},{"title":"Changelog","mode":"wide","href":"/support/changelog"},{"title":"Thoughtly referral program","sidebarTitle":"Referral Program","href":"/support/referral-program"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/agent/get-agents"}]},{"tab":"Promptbooks","pages":[{"title":"Promptbooks","href":"/promptbooks/browse"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/getting-started"}]}]},"basePath":"","title":"WhatsApp Business - Thoughtly Docs","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}