Set up Webhook or SSE event delivery for your WSAPI Cloud instances
After pairing your instance, configure how you want to receive event notifications (messages, chats, group updates, etc.) at wsapi.chat/app/settings.In the Instance Setting Defaults section, you can select the Event Delivery mode (Webhook or Pull Mode with SSE).
Your public HTTPS endpoint that will receive events
Yes
Event Signature Secret
Secret used to sign webhook events for verification
Recommended
Always configure signature verification for webhook events to validate the legitimacy of incoming webhook calls. Without it, anyone who discovers your webhook URL could send fake events.
Secret used to sign webhook events for verification
Recommended
In SSE mode, signing events is still recommended to ensure the integrity of the event stream. Always verify signatures on incoming events to protect against tampering or spoofing.
Your app opens a persistent SSE connection to WSAPI
Events are streamed to your app in real time as they occur
If the connection drops, your app reconnects and resumes
We recommend using this mode with one of our official SDKs, which include a proper SSE client implementation. If your language isn’t supported, refer to the SDK’s implementation as a reference.
The event delivery mode you select in the dashboard applies as a default for all instances. However, you can override this on a per-instance basis under the Instance Settings section in the instance details page. This allows you to have different instances using different delivery modes if needed. When overriding settings for an instance, event filtering will also be applied based on the instance’s specific configuration.
⌘I
{"docsConfig":{"theme":"linden","$schema":"https://mintlify.com/docs.json","name":"WSAPI Docs","description":"Documentation for WSAPI - Open-Source WhatsApp API","colors":{"primary":"#00c471","light":"#00c471","dark":"#00c471"},"logo":{"light":"https://mintcdn.com/wsapi/fNFs11a02_2YR4nU/logo/light.svg?fit=max\u0026auto=format\u0026n=fNFs11a02_2YR4nU\u0026q=85\u0026s=33629b39555f35a3fd74954a0834740b","dark":"https://mintcdn.com/wsapi/fNFs11a02_2YR4nU/logo/dark.svg?fit=max\u0026auto=format\u0026n=fNFs11a02_2YR4nU\u0026q=85\u0026s=174813e7ed96ec4f35a46b0f4a5d57cf","href":"https://wsapi.chat"},"favicon":"https://mintcdn.com/wsapi/fNFs11a02_2YR4nU/favicon.svg?fit=max\u0026auto=format\u0026n=fNFs11a02_2YR4nU\u0026q=85\u0026s=df3cdbf6a0e2294e23e5346d08b31ed7","api":{"openapi":"openapi/wsapi-api.yaml","playground":{"display":"interactive"},"examples":{"languages":["bash","python","javascript","csharp"]}},"appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://github.com/wsapi-chat/wsapi-app","type":"github"}],"primary":{"type":"button","label":"Get Started","href":"https://wsapi.chat"}},"footer":{"socials":{"github":"https://github.com/wsapi-chat/wsapi-app","website":"https://wsapi.chat"}},"integrations":{"ga4":{"measurementId":"G-6W5YVX2ZC4"}},"styling":{"latex":false},"background":{"color":{"light":"#f7fdfb","dark":"#090f0e"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"wsapi","hasAudioNarration":false,"actualSubdomain":"wsapi","customDomains":["docs.wsapi.chat"],"gitSource":{"type":"github","owner":"marianodrzazga","repo":"wsapi-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad2a90b0eeda75294e1f051","collectionId":"ee92b118-b948-4cc7-9f2b-b604ab55b691","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad2a90b0eeda75294e1f051"},"entitlements":{},"buildId":"6ad2a90b0eeda75294e1f051","clientVersion":"0.0.3908","searchFilterCounts":[{"language":"default","tag":"API Reference","count":118},{"language":"default","tag":"Endpoints","count":116},{"language":"default","tag":"Events","count":45},{"language":"default","tag":"Messages","count":24},{"language":"default","tag":"Groups","count":21},{"language":"default","tag":"Chats","count":19},{"language":"default","tag":"Communities","count":16},{"language":"default","tag":"Documentation","count":14},{"language":"default","tag":"Account","count":13},{"language":"default","tag":"Session","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-branches-v2-autocommit","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-branches-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"teamspace","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"client-snapshot-docs-config","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":":root{--brand-green:#00c471}.dark{--tw-prose-code:#00c471}code:not(pre code){color:var(--brand-green)}"}],"page":{"pagePath":"basics/configuring-instance","slug":"/basics/configuring-instance","pageMetadata":{"title":"Configuring Event Delivery","description":"Set up Webhook or SSE event delivery for your WSAPI Cloud instances","href":"/basics/configuring-instance"},"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: \"Set up Webhook or SSE event delivery for your WSAPI Cloud instances\"\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`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,CardGroup,Heading,Info,Tab,Table,Tabs,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`After pairing your instance, configure how you want to receive event notifications (messages, chats, group updates, etc.) at `,_jsx(_components.a,{href:`https://wsapi.chat/app/settings`,children:`wsapi.chat/app/settings`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Instance Setting Defaults`}),` section, you can select the Event Delivery mode (Webhook or Pull Mode with SSE).`]}),`\n`,_jsx(Heading,{level:`2`,id:`event-delivery-modes`,children:`Event delivery modes`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Webhook Mode`,id:`webhook-mode`,\"data-child-heading-ids\":`[\"configuration\",\"how-it-works\"]`,children:[_jsx(_components.p,{children:`In Webhook mode, WSAPI Cloud sends events to a public endpoint you specify via HTTP POST requests with a JSON payload.`}),_jsx(Heading,{level:`3`,id:`configuration`,children:`Configuration`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Webhook URL`})}),_jsx(_components.td,{children:`Your public HTTPS endpoint that will receive events`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Event Signature Secret`})}),_jsx(_components.td,{children:`Secret used to sign webhook events for verification`}),_jsx(_components.td,{children:`Recommended`})]})]})]}),_jsx(Warning,{children:_jsx(_components.p,{children:`Always configure signature verification for webhook events to validate the legitimacy of incoming webhook calls. Without it, anyone who discovers your webhook URL could send fake events.`})}),_jsx(Heading,{level:`3`,id:`how-it-works`,children:`How it works`}),_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`An event occurs on your WhatsApp instance (e.g., new message received)`}),`\n`,_jsx(_components.li,{children:`WSAPI sends a POST request to your webhook URL with the event payload`}),`\n`,_jsxs(_components.li,{children:[`Your server processes the event and returns a `,_jsx(_components.code,{children:`200`}),` response`]}),`\n`]}),_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/events/overview`,children:`Events overview`}),` for payload formats and delivery details.`]})]}),_jsxs(Tab,{title:`Pull Mode (SSE)`,id:`pull-mode-sse`,\"data-child-heading-ids\":`[\"configuration-2\",\"how-it-works-2\",\"supported-sdks\"]`,children:[_jsxs(_components.p,{children:[`In pull mode, your application connects to WSAPI using `,_jsx(_components.strong,{children:`Server-Sent Events (SSE)`}),`. This eliminates the need for a public endpoint to receive webhooks.`]}),_jsx(Heading,{level:`3`,id:`configuration-2`,children:`Configuration`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Required`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Event Signature Secret`})}),_jsx(_components.td,{children:`Secret used to sign webhook events for verification`}),_jsx(_components.td,{children:`Recommended`})]})})]}),_jsx(Warning,{children:_jsx(_components.p,{children:`In SSE mode, signing events is still recommended to ensure the integrity of the event stream. Always verify signatures on incoming events to protect against tampering or spoofing.`})}),_jsx(Heading,{level:`3`,id:`how-it-works-2`,children:`How it works`}),_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Your app opens a persistent SSE connection to WSAPI`}),`\n`,_jsx(_components.li,{children:`Events are streamed to your app in real time as they occur`}),`\n`,_jsx(_components.li,{children:`If the connection drops, your app reconnects and resumes`}),`\n`]}),_jsx(Info,{children:_jsx(_components.p,{children:`We recommend using this mode with one of our official SDKs, which include a proper SSE client implementation. If your language isn’t supported, refer to the SDK’s implementation as a reference.`})}),_jsx(Heading,{level:`3`,id:`supported-sdks`,children:`Supported SDKs`}),_jsxs(CardGroup,{cols:3,children:[_jsx(Card,{title:`Node.js`,icon:`js`,href:`/sdks/nodejs`,children:_jsx(_components.p,{children:`TypeScript/JavaScript SDK`})}),_jsx(Card,{title:`.NET`,icon:`microsoft`,href:`/sdks/dotnet`,children:_jsx(_components.p,{children:`C# / .NET 7+ SDK`})}),_jsx(Card,{title:`Python`,icon:`python`,href:`/sdks/python`,children:_jsx(_components.p,{children:`Python SDK`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`per-instance-vs-global-settings`,children:`Per-instance vs. global settings`}),`\n`,_jsxs(_components.p,{children:[`The event delivery mode you select in the dashboard applies as a default for all instances. However, you can override this on a per-instance basis under the `,_jsx(_components.strong,{children:`Instance Settings`}),` section in the instance details page. This allows you to have different instances using different delivery modes if needed. When overriding settings for an instance, event filtering will also be applied based on the instance’s specific configuration.`]})]})}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":"Configuring Event Delivery","description":"Set up Webhook or SSE event delivery for your WSAPI Cloud instances","href":"/basics/configuring-instance"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Event delivery modes","slug":"event-delivery-modes","depth":2,"children":[{"title":"Configuration","slug":"configuration","depth":3,"children":[],"tabId":"webhook-mode"},{"title":"How it works","slug":"how-it-works","depth":3,"children":[],"tabId":"webhook-mode"},{"title":"Configuration","slug":"configuration-2","depth":3,"children":[],"tabId":"pull-mode-sse"},{"title":"How it works","slug":"how-it-works-2","depth":3,"children":[],"tabId":"pull-mode-sse"},{"title":"Supported SDKs","slug":"supported-sdks","depth":3,"children":[],"tabId":"pull-mode-sse"}]},{"title":"Per-instance vs. global settings","slug":"per-instance-vs-global-settings","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"wsapi","siteName":"WSAPI Docs","title":"Configuring Event Delivery - WSAPI Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-05T23:05:17.665Z","originalFileLocation":"basics/configuring-instance.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=\"dark\"}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=\"Set up Webhook or SSE event delivery for your WSAPI Cloud instances\">\u003cmeta data-mint-head name=\"application-name\" content=\"WSAPI 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/wsapi/FCf4ui-10c9VRiJ-/_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/wsapi/FCf4ui-10c9VRiJ-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/wsapi/FCf4ui-10c9VRiJ-/_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/wsapi/FCf4ui-10c9VRiJ-/_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/wsapi/FCf4ui-10c9VRiJ-/_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/wsapi/FCf4ui-10c9VRiJ-/_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/wsapi/FCf4ui-10c9VRiJ-/_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/wsapi/FCf4ui-10c9VRiJ-/_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/wsapi/FCf4ui-10c9VRiJ-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Configuring Event Delivery - WSAPI Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Set up Webhook or SSE event delivery for your WSAPI Cloud instances\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"WSAPI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.wsapi.chat/basics/configuring-instance\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Configuring Event Delivery - WSAPI Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Set up Webhook or SSE event delivery for your WSAPI Cloud instances\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/wsapi/FCf4ui-10c9VRiJ-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"WSAPI Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00c471\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.wsapi.chat/basics/configuring-instance\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/basics/configuring-instance.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.wsapi.chat/#organization\",\"name\":\"WSAPI Docs\",\"url\":\"https://docs.wsapi.chat\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/wsapi/fNFs11a02_2YR4nU/logo/light.svg?fit=max\u0026auto=format\u0026n=fNFs11a02_2YR4nU\u0026q=85\u0026s=33629b39555f35a3fd74954a0834740b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.wsapi.chat#website\",\"name\":\"WSAPI Docs\",\"url\":\"https://docs.wsapi.chat\",\"publisher\":{\"@id\":\"https://docs.wsapi.chat/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.wsapi.chat/basics/configuring-instance#webpage\",\"url\":\"https://docs.wsapi.chat/basics/configuring-instance\",\"name\":\"Configuring Event Delivery\",\"description\":\"Set up Webhook or SSE event delivery for your WSAPI Cloud instances\",\"dateModified\":\"2026-03-05T23:05:17.665Z\",\"isPartOf\":{\"@id\":\"https://docs.wsapi.chat#website\"},\"breadcrumb\":{\"@id\":\"https://docs.wsapi.chat/basics/configuring-instance#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.wsapi.chat/basics/configuring-instance#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Basics\",\"item\":\"https://docs.wsapi.chat/basics/free-trial\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Configuring Event Delivery\",\"item\":\"https://docs.wsapi.chat/basics/configuring-instance\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.wsapi.chat/basics/configuring-instance#article\",\"headline\":\"Configuring Event Delivery\",\"name\":\"Configuring Event Delivery\",\"description\":\"Set up Webhook or SSE event delivery for your WSAPI Cloud instances\",\"url\":\"https://docs.wsapi.chat/basics/configuring-instance\",\"mainEntityOfPage\":{\"@id\":\"https://docs.wsapi.chat/basics/configuring-instance#webpage\"},\"dateModified\":\"2026-03-05T23:05:17.665Z\",\"publisher\":{\"@id\":\"https://docs.wsapi.chat/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.wsapi.chat#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"WSAPI Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"WSAPI Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Quickstart","href":"/getting-started/quickstart"}]},{"group":"Basics","pages":[{"title":"Free Trial","href":"/basics/free-trial"},{"title":"API Key","href":"/basics/api-key"},{"title":"Pairing Your Instance","description":"Connect your WhatsApp account to a WSAPI instance","href":"/basics/pairing-instance"},{"title":"Configuring Event Delivery","href":"/basics/configuring-instance"},{"title":"Event Filtering","description":"Control which events your instance receives","href":"/basics/event-filtering"},{"title":"Initial Sync","href":"/basics/initial-sync"}]},{"group":"SDKs \u0026 Libraries","pages":[{"title":"SDKs \u0026 Libraries","href":"/sdks/overview"},{"title":"Node.js / TypeScript SDK","href":"/sdks/nodejs"},{"title":".NET SDK","href":"/sdks/dotnet"},{"title":"Python SDK","href":"/sdks/python"}]},{"group":"Integrations","pages":[{"title":"n8n Community Node","href":"/integrations/n8n-wsapi"},{"title":"MCP Server","href":"/integrations/mcp-server"},{"title":"CLI","href":"/integrations/cli"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]},{"tab":"Events","pages":[{"title":"Events","href":"/events/overview"}]}]},"title":"Configuring Event Delivery - WSAPI Docs","buildId":"dpl_CUnGQP1HgFUzoxatVC37y4zP83Vx","deploymentId":"dpl_CUnGQP1HgFUzoxatVC37y4zP83Vx","dynamics":[],"chunks":[]}