Autentique com uma chave secreta (sk_live_…) ou uma chave restrita
(rk_live_…) criada no painel. Chaves restritas só têm as permissões
escolhidas na criação, como messages:send, chats:read ou
broadcasts:send.
O segredo de assinatura. Só é devolvido quando o endpoint é criado.
Exemplo:
"whsec_7f2b…"
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"blü","description":"Guias do blü para conectar seu WhatsApp, enviar campanhas e configurar seu atendimento.","colors":{"primary":"#1372D8","light":"#60BFFB","dark":"#1372D8"},"logo":{"light":"https://mintcdn.com/blu-direct/Hl1PYGRVJfCuUquW/images/logo-light.svg?fit=max\u0026auto=format\u0026n=Hl1PYGRVJfCuUquW\u0026q=85\u0026s=c1dcb7084caf500aa1bfc7cdeb9b6ac0","dark":"https://mintcdn.com/blu-direct/Hl1PYGRVJfCuUquW/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=Hl1PYGRVJfCuUquW\u0026q=85\u0026s=fa99a453fc822cd3eba2e6a691d211f8"},"favicon":"https://mintcdn.com/blu-direct/Hl1PYGRVJfCuUquW/favicon.png?fit=max\u0026auto=format\u0026n=Hl1PYGRVJfCuUquW\u0026q=85\u0026s=c2c1393657e4303529d0c50baafac6cd","appearance":{"default":"light"},"navbar":{"links":[{"href":"https://blu.direct","label":"Site"},{"href":"https://wa.me/559186130008?text=Ol%C3%A1%2C+preciso+de+ajuda+com+o+Bl%C3%BC","label":"Suporte"}],"primary":{"type":"button","label":"Abrir painel","href":"https://blu.direct/app"}},"footer":{"socials":{"instagram":"https://instagram.com/blu.direct"},"links":[{"header":"blü","items":[{"label":"Site","href":"https://blu.direct"},{"label":"Blog","href":"https://blu.direct/blog"},{"label":"Privacidade","href":"https://blu.direct/privacy-policy"}]}]},"fonts":{"family":"IBM Plex Sans"},"integrations":{"posthog":{"apiKey":"phc_d8dj2oBM4jNkdVwrYwk9vufNUSLIJBj3uxOxg27NEnk","apiHost":"https://p.blu.direct","sessionRecording":false}},"styling":{"latex":false},"navigation":{"languages":[{"language":"pt-BR","default":true,"href":""}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"blu-direct","hasAudioNarration":false,"actualSubdomain":"blu-direct","customDomains":["docs.blu.direct"],"gitSource":{"type":"github","owner":"leoffx","repo":"blu","deployBranch":"master","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adb7f2d2d3c9c6f3279f179","collectionId":"f28bf980-b5d9-4af3-b68d-080d3c8f26ed","liveDeploymentHistoryId":"6adb7f2d2d3c9c6f3279f179","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6adb7f2d2d3c9c6f3279f179","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"pt-BR","tag":"API \u0026 SDKs","count":45},{"language":"pt-BR","tag":"Referência da API","count":43},{"language":"pt-BR","tag":"Guias","count":28},{"language":"pt-BR","tag":"Campanhas","count":9},{"language":"pt-BR","tag":"Atendimento","count":6},{"language":"pt-BR","tag":"Comece por aqui","count":6},{"language":"pt-BR","tag":"Contatos","count":6},{"language":"pt-BR","tag":"Integrações","count":5},{"language":"pt-BR","tag":"Endpoints de webhook","count":5},{"language":"pt-BR","tag":"Etiquetas","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"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":"editor-version-history-v2","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":"vite-origin","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":"billing-updated-9-15","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":true},"customCss":[{"filePath":"custom.css","content":".dark img[src*=\"/images/icons/\"]{filter:invert(1)}"}],"page":{"pagePath":"api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook","slug":"/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook","pageMetadata":{"title":"Criar um endpoint de webhook","description":"A resposta inclui o `secret` de assinatura. Ele só é devolvido aqui.","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/webhook_endpoints","href":"/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"A resposta inclui o \", _jsx(_components.code, {\n children: \"secret\"\n }), \" de assinatura. Ele só é devolvido aqui.\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Criar um endpoint de webhook","description":"A resposta inclui o `secret` de assinatura. Ele só é devolvido aqui.","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/webhook_endpoints","href":"/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Endpoints de webhook"],"operationId":"createWebhookEndpoint","summary":"Criar um endpoint de webhook","description":"A resposta inclui o `secret` de assinatura. Ele só é devolvido aqui.","parameters":["ca4e510b-4bf2-444e-9023-aac1170f0426"],"requestBody":"3058a509-cfa1-4342-9a6d-6e75d1192246","responses":{"200":"7372beb3-d656-4d4a-940b-38dcf48c8c6f","4XX":"f113ee22-8aaa-40c1-be6f-88646e88dbf2","5XX":"dddc8c31-c638-4a70-8f34-8fa22c9af276"},"method":"post","type":"path","servers":["a7e13cee-51ea-4adc-ac59-16049f87cb99"],"security":["9b5a2af2-07dc-4788-9af3-526735b82f4a"],"path":"/v1/webhook_endpoints","baseUrlOptions":["https://api.blu.direct"],"title":"Criar um endpoint de webhook","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ca4e510b-4bf2-444e-9023-aac1170f0426":{"name":"Idempotency-Key","in":"header","description":"Uma chave única, como um UUID, que torna seguro repetir esta requisição por 24 horas.","schema":{"type":"string","maxLength":255,"description":"Uma chave única, como um UUID, que torna seguro repetir esta requisição por 24 horas.","uniqueKey":"","typeLabel":"string"}},"fca9064c-3128-42a3-8917-50fdd3e51152":{"name":"Blu-Version","in":"header","description":"A versão da API a usar. Por padrão, é a versão fixada na sua conta.","schema":{"type":"string","examples":["2026-10-11"],"description":"A versão da API a usar. Por padrão, é a versão fixada na sua conta.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url","enabled_events"],"properties":{"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"url","typeLabel":"string\u003curi>"},"enabled_events":{"description":"Tipos de evento a enviar, ou `[\"*\"]` para todos.","type":"array","minItems":1,"items":{"oneOf":[{"type":"string","description":"- `message.received`: chegou uma mensagem. `data.object` é a mensagem.\n- `message.updated`: o status de uma mensagem enviada mudou. `data.object` é a mensagem.\n- `phone_number.connected` / `phone_number.disconnected`: `data.object` é o número.\n- `broadcast.completed` / `broadcast.failed`: `data.object` é a campanha.\n","enum":["message.received","message.updated","phone_number.connected","phone_number.disconnected","broadcast.completed","broadcast.failed"],"uniqueKey":"enabled_events.items.[INDEX].oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","const":"*","uniqueKey":"enabled_events.items.[INDEX].oneOf.1","typeLabel":"string"}],"uniqueKey":"enabled_events.items.[INDEX]","typeLabel":"enum\u003cstring> | string"},"isRequired":true,"uniqueKey":"enabled_events","typeLabel":"(enum\u003cstring> | string)[]"},"description":{"type":"string","maxLength":200,"uniqueKey":"description","typeLabel":"string"},"metadata":{"description":"Até 50 pares de chave e valor seus. Chaves com até 40 caracteres e valores com até 500.","type":"object","maxProperties":50,"propertyNames":{"maxLength":40},"additionalProperties":{"type":"string","maxLength":500,"uniqueKey":"metadata.additionalProperties","typeLabel":"string"},"uniqueKey":"metadata","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"url":"\u003cstring>","enabled_events":[],"description":"\u003cstring>","metadata":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"7372beb3-d656-4d4a-940b-38dcf48c8c6f":{"description":"O novo endpoint de webhook, com o `secret` dele.","content":{"application/json":{"schema":{"type":"object","required":["id","object","url","enabled_events","status","description","api_version","created","metadata"],"properties":{"id":{"type":"string","pattern":"^we_","examples":["we_3Mx9"],"isRequired":true,"uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","const":"webhook_endpoint","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"url","typeLabel":"string\u003curi>"},"enabled_events":{"description":"Tipos de evento a enviar, ou `[\"*\"]` para todos.","type":"array","minItems":1,"items":{"oneOf":[{"type":"string","description":"- `message.received`: chegou uma mensagem. `data.object` é a mensagem.\n- `message.updated`: o status de uma mensagem enviada mudou. `data.object` é a mensagem.\n- `phone_number.connected` / `phone_number.disconnected`: `data.object` é o número.\n- `broadcast.completed` / `broadcast.failed`: `data.object` é a campanha.\n","enum":["message.received","message.updated","phone_number.connected","phone_number.disconnected","broadcast.completed","broadcast.failed"],"uniqueKey":"enabled_events.items.[INDEX].oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","const":"*","uniqueKey":"enabled_events.items.[INDEX].oneOf.1","typeLabel":"string"}],"uniqueKey":"enabled_events.items.[INDEX]","typeLabel":"enum\u003cstring> | string"},"isRequired":true,"uniqueKey":"enabled_events","typeLabel":"(enum\u003cstring> | string)[]"},"status":{"type":"string","enum":["enabled","disabled"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"description":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"description","typeLabel":"string | null"},"api_version":{"description":"A versão da API usada para montar os eventos.","type":"string","isRequired":true,"uniqueKey":"api_version","typeLabel":"string"},"created":{"description":"Horário Unix em segundos.","type":"integer","examples":[1760190012],"isRequired":true,"uniqueKey":"created","typeLabel":"integer"},"metadata":{"description":"Até 50 pares de chave e valor seus. Chaves com até 40 caracteres e valores com até 500.","type":"object","maxProperties":50,"propertyNames":{"maxLength":40},"additionalProperties":{"type":"string","maxLength":500,"uniqueKey":"metadata.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"metadata","typeLabel":"object"},"secret":{"description":"O segredo de assinatura. Só é devolvido quando o endpoint é criado.","type":"string","examples":["whsec_7f2b…"],"uniqueKey":"secret","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"we_3Mx9","object":"webhook_endpoint","url":"\u003cstring>","enabled_events":["message.received"],"status":"enabled","description":"\u003cstring>","api_version":"\u003cstring>","created":1760190012,"metadata":{},"secret":"whsec_7f2b…"}}},"exampleType":"generated"}},"exampleType":"generated"},"f113ee22-8aaa-40c1-be6f-88646e88dbf2":{"description":"A requisição falhou. Códigos de status: `400` requisição inválida, `401`\nchave de API inválida, `403` a chave não tem a permissão, `404` não\nencontrado, `409` conflito (como uma `Idempotency-Key` reutilizada com\nparâmetros diferentes), `422` uma regra do WhatsApp recusou a requisição,\n`429` limite de requisições atingido, `5xx` erro do lado do blü.\n","headers":{"Request-Id":{"description":"Identifica a requisição. Informe esse valor ao falar com o suporte.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","whatsapp_error","rate_limit_error","api_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"description":"Uma mensagem legível para pessoas.","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"code":{"description":"Um texto curto que identifica o erro específico, quando houver.\n\n- `whatsapp_error`: `phone_number_disconnected`, `not_on_whatsapp`,\n `outside_service_window`, `template_not_approved`,\n `unsupported_for_platform_type`, `contact_opted_out`,\n `marketing_stopped`, `media_too_large`.\n- `invalid_request_error`: `parameter_missing`, `parameter_invalid`,\n `resource_missing`, `idempotency_key_reused`,\n `broadcast_not_draft`, `consent_required`, `plan_limit_reached`.\n","type":"string","examples":["outside_service_window"],"uniqueKey":"error.code","typeLabel":"string"},"param":{"description":"O parâmetro da requisição relacionado ao erro, se houver.","type":"string","examples":["text.body"],"uniqueKey":"error.param","typeLabel":"string"},"doc_url":{"type":"string","format":"uri","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","message":"\u003cstring>","request_id":"\u003cstring>","code":"outside_service_window","param":"text.body","doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"dddc8c31-c638-4a70-8f34-8fa22c9af276":{"description":"A requisição falhou. Códigos de status: `400` requisição inválida, `401`\nchave de API inválida, `403` a chave não tem a permissão, `404` não\nencontrado, `409` conflito (como uma `Idempotency-Key` reutilizada com\nparâmetros diferentes), `422` uma regra do WhatsApp recusou a requisição,\n`429` limite de requisições atingido, `5xx` erro do lado do blü.\n","headers":{"Request-Id":{"description":"Identifica a requisição. Informe esse valor ao falar com o suporte.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","whatsapp_error","rate_limit_error","api_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"description":"Uma mensagem legível para pessoas.","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"code":{"description":"Um texto curto que identifica o erro específico, quando houver.\n\n- `whatsapp_error`: `phone_number_disconnected`, `not_on_whatsapp`,\n `outside_service_window`, `template_not_approved`,\n `unsupported_for_platform_type`, `contact_opted_out`,\n `marketing_stopped`, `media_too_large`.\n- `invalid_request_error`: `parameter_missing`, `parameter_invalid`,\n `resource_missing`, `idempotency_key_reused`,\n `broadcast_not_draft`, `consent_required`, `plan_limit_reached`.\n","type":"string","examples":["outside_service_window"],"uniqueKey":"error.code","typeLabel":"string"},"param":{"description":"O parâmetro da requisição relacionado ao erro, se houver.","type":"string","examples":["text.body"],"uniqueKey":"error.param","typeLabel":"string"},"doc_url":{"type":"string","format":"uri","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","message":"\u003cstring>","request_id":"\u003cstring>","code":"outside_service_window","param":"text.body","doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"9b5a2af2-07dc-4788-9af3-526735b82f4a":{"secretKey":{"type":"http","scheme":"bearer","description":"Autentique com uma chave secreta (`sk_live_…`) ou uma chave restrita\n(`rk_live_…`) criada no painel. Chaves restritas só têm as permissões\nescolhidas na criação, como `messages:send`, `chats:read` ou\n`broadcasts:send`.\n","scopes":[],"schemeName":"secretKey"}}},"servers":{"a7e13cee-51ea-4adc-ac59-16049f87cb99":{"url":"https://api.blu.direct"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Autentique com uma chave secreta (`sk_live_…`) ou uma chave restrita\n(`rk_live_…`) criada no painel. Chaves restritas só têm as permissões\nescolhidas na criação, como `messages:send`, `chats:read` ou\n`broadcasts:send`.\n","scopes":[],"schemeName":"secretKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Autentique com uma chave secreta (`sk_live_…`) ou uma chave restrita\n(`rk_live_…`) criada no painel. Chaves restritas só têm as permissões\nescolhidas na criação, como `messages:send`, `chats:read` ou\n`broadcasts:send`.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"secretKey","name":"Authorization"}],"title":"secretKey"}]},"originalFileLocation":"api/openapi.yaml"},"subdomain":"blu-direct","siteName":"blü","title":"Criar um endpoint de webhook - blü","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook","matchLevel":0}}},"lastModified":"2026-10-23T15:37:37.388Z","originalFileLocation":"api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook.mdx","locale":"pt-BR"},"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=\"light\"}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=\"A resposta inclui o secret de assinatura. Ele só é devolvido aqui.\">\u003cmeta data-mint-head name=\"application-name\" content=\"blü\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Criar um endpoint de webhook - blü\">\u003cmeta data-mint-head property=\"og:description\" content=\"A resposta inclui o secret de assinatura. Ele só é devolvido aqui.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"blü\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.blu.direct/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://blu-direct.mintlify.app/_mintlify/api/og/v2?division=Endpoints+de+webhook\u0026amp;title=Criar+um+endpoint+de+webhook\u0026amp;description=A+resposta+inclui+o+%60secret%60+de+assinatura.+Ele+s%C3%B3+%C3%A9+devolvido+aqui.\u0026amp;theme=bd8bce0f56b5608060d22437\u0026amp;signature=f22eaadc026f58c2f965328b461605c2d1260e7a6b76e638ba6bd1d262232e89\">\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=\"Criar um endpoint de webhook - blü\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"A resposta inclui o secret de assinatura. Ele só é devolvido aqui.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://blu-direct.mintlify.app/_mintlify/api/og/v2?division=Endpoints+de+webhook\u0026amp;title=Criar+um+endpoint+de+webhook\u0026amp;description=A+resposta+inclui+o+%60secret%60+de+assinatura.+Ele+s%C3%B3+%C3%A9+devolvido+aqui.\u0026amp;theme=bd8bce0f56b5608060d22437\u0026amp;signature=f22eaadc026f58c2f965328b461605c2d1260e7a6b76e638ba6bd1d262232e89\">\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/blu-direct/yPgrVpF5wEWF6j0S/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"blü\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1372D8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.blu.direct/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.blu.direct/#organization\",\"name\":\"blü\",\"url\":\"https://docs.blu.direct\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/blu-direct/Hl1PYGRVJfCuUquW/images/logo-light.svg?fit=max\u0026auto=format\u0026n=Hl1PYGRVJfCuUquW\u0026q=85\u0026s=c1dcb7084caf500aa1bfc7cdeb9b6ac0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.blu.direct#website\",\"name\":\"blü\",\"url\":\"https://docs.blu.direct\",\"publisher\":{\"@id\":\"https://docs.blu.direct/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.blu.direct/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook#webpage\",\"url\":\"https://docs.blu.direct/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook\",\"name\":\"Criar um endpoint de webhook\",\"description\":\"A resposta inclui o secret de assinatura. Ele só é devolvido aqui.\",\"dateModified\":\"2026-10-23T15:37:37.388Z\",\"isPartOf\":{\"@id\":\"https://docs.blu.direct#website\"},\"breadcrumb\":{\"@id\":\"https://docs.blu.direct/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.blu.direct/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Referência da API\",\"item\":\"https://docs.blu.direct/api-reference/conta/consultar-a-conta\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Endpoints de webhook\",\"item\":\"https://docs.blu.direct/api-reference/endpoints-de-webhook/listar-endpoints-de-webhook\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Criar um endpoint de webhook\",\"item\":\"https://docs.blu.direct/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.blu.direct/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook#apireference\",\"headline\":\"Criar um endpoint de webhook\",\"name\":\"Criar um endpoint de webhook\",\"description\":\"A resposta inclui o secret de assinatura. Ele só é devolvido aqui.\",\"url\":\"https://docs.blu.direct/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook\",\"mainEntityOfPage\":{\"@id\":\"https://docs.blu.direct/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook#webpage\"},\"dateModified\":\"2026-10-23T15:37:37.388Z\",\"publisher\":{\"@id\":\"https://docs.blu.direct/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.blu.direct#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"blü\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"blü","nav":{"global":null,"languages":[{"language":"pt-BR","default":true,"tabs":[{"tab":"Guias","pages":[{"title":"Guias","href":""}]},{"tab":"API \u0026 SDKs","groups":[{"group":"Desenvolvedores","pages":[{"title":"Desenvolva com o blü","sidebarTitle":"API e ferramentas","icon":"https://mintlify.s3.us-west-1.amazonaws.com/blu-direct/images/icons/code.svg","href":"/api/visao-geral"},{"title":"SDKs do blü","sidebarTitle":"SDKs","icon":"https://mintlify.s3.us-west-1.amazonaws.com/blu-direct/images/icons/sdk.svg","href":"/sdks/visao-geral"}]},{"group":"Referência da API","pages":[{"group":"Conta","pages":[{"title":"Consultar a conta","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/account","href":"/api-reference/conta/consultar-a-conta"}]},{"group":"Números","pages":[{"title":"Listar números","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/phone_numbers","href":"/api-reference/números/listar-números"},{"title":"Consultar um número","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/phone_numbers/{phone_number}","href":"/api-reference/números/consultar-um-número"},{"title":"Atualizar um número","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/phone_numbers/{phone_number}","href":"/api-reference/números/atualizar-um-número"}]},{"group":"Contatos","pages":[{"title":"Listar contatos","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/contacts","href":"/api-reference/contatos/listar-contatos"},{"title":"Criar um contato","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/contacts","href":"/api-reference/contatos/criar-um-contato"},{"title":"Consultar um contato","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/contacts/{contact}","href":"/api-reference/contatos/consultar-um-contato"},{"title":"Atualizar um contato","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/contacts/{contact}","href":"/api-reference/contatos/atualizar-um-contato"},{"title":"Excluir um contato","deprecated":null,"version":null,"openapi":"/api/openapi.yaml delete /v1/contacts/{contact}","href":"/api-reference/contatos/excluir-um-contato"},{"title":"Verificar números no WhatsApp","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/contacts/lookup","href":"/api-reference/contatos/verificar-números-no-whatsapp"}]},{"group":"Conversas","pages":[{"title":"Listar conversas","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/chats","href":"/api-reference/conversas/listar-conversas"},{"title":"Abrir uma conversa","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/chats","href":"/api-reference/conversas/abrir-uma-conversa"},{"title":"Consultar uma conversa","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/chats/{chat}","href":"/api-reference/conversas/consultar-uma-conversa"},{"title":"Atualizar uma conversa","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/chats/{chat}","href":"/api-reference/conversas/atualizar-uma-conversa"}]},{"group":"Mensagens","pages":[{"title":"Listar as mensagens de uma conversa","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/chats/{chat}/messages","href":"/api-reference/mensagens/listar-as-mensagens-de-uma-conversa"},{"title":"Enviar uma mensagem","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/chats/{chat}/messages","href":"/api-reference/mensagens/enviar-uma-mensagem"},{"title":"Consultar uma mensagem","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/chats/{chat}/messages/{message}","href":"/api-reference/mensagens/consultar-uma-mensagem"}]},{"group":"Mídia","pages":[{"title":"Enviar mídia","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/media","href":"/api-reference/mídia/enviar-mídia"},{"title":"Consultar mídia","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/media/{media}","href":"/api-reference/mídia/consultar-mídia"}]},{"group":"Etiquetas","pages":[{"title":"Listar etiquetas","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/labels","href":"/api-reference/etiquetas/listar-etiquetas"},{"title":"Criar uma etiqueta","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/labels","href":"/api-reference/etiquetas/criar-uma-etiqueta"},{"title":"Consultar uma etiqueta","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/labels/{label}","href":"/api-reference/etiquetas/consultar-uma-etiqueta"},{"title":"Atualizar uma etiqueta","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/labels/{label}","href":"/api-reference/etiquetas/atualizar-uma-etiqueta"},{"title":"Excluir uma etiqueta","deprecated":null,"version":null,"openapi":"/api/openapi.yaml delete /v1/labels/{label}","href":"/api-reference/etiquetas/excluir-uma-etiqueta"}]},{"group":"Modelos de mensagem","pages":[{"title":"Listar modelos de mensagem","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/message_templates","href":"/api-reference/modelos-de-mensagem/listar-modelos-de-mensagem"},{"title":"Consultar um modelo de mensagem","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/message_templates/{message_template}","href":"/api-reference/modelos-de-mensagem/consultar-um-modelo-de-mensagem"}]},{"group":"Campanhas","pages":[{"title":"Listar campanhas","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/broadcasts","href":"/api-reference/campanhas/listar-campanhas"},{"title":"Criar uma campanha","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/broadcasts","href":"/api-reference/campanhas/criar-uma-campanha"},{"title":"Consultar uma campanha","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/broadcasts/{broadcast}","href":"/api-reference/campanhas/consultar-uma-campanha"},{"title":"Atualizar uma campanha","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/broadcasts/{broadcast}","href":"/api-reference/campanhas/atualizar-uma-campanha"},{"title":"Enviar uma campanha","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/broadcasts/{broadcast}/send","href":"/api-reference/campanhas/enviar-uma-campanha"}]},{"group":"Agentes","pages":[{"title":"Listar agentes","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/agents","href":"/api-reference/agentes/listar-agentes"},{"title":"Consultar um agente","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/agents/{agent}","href":"/api-reference/agentes/consultar-um-agente"},{"title":"Atualizar um agente","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/agents/{agent}","href":"/api-reference/agentes/atualizar-um-agente"},{"title":"Simular um agente","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/agents/{agent}/simulate","href":"/api-reference/agentes/simular-um-agente"}]},{"group":"Eventos","pages":[{"title":"Listar eventos","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/events","href":"/api-reference/eventos/listar-eventos"},{"title":"Consultar um evento","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/events/{event}","href":"/api-reference/eventos/consultar-um-evento"},{"title":"Entrega de eventos","version":null,"deprecated":null,"openapi":"/api/openapi.yaml webhook event","href":"/api-reference/eventos/entrega-de-eventos"}]},{"group":"Endpoints de webhook","pages":[{"title":"Listar endpoints de webhook","description":null,"deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/webhook_endpoints","href":"/api-reference/endpoints-de-webhook/listar-endpoints-de-webhook"},{"title":"Criar um endpoint de webhook","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/webhook_endpoints","href":"/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook"},{"title":"Consultar um endpoint de webhook","description":null,"deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/webhook_endpoints/{webhook_endpoint}","href":"/api-reference/endpoints-de-webhook/consultar-um-endpoint-de-webhook"},{"title":"Atualizar um endpoint de webhook","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/webhook_endpoints/{webhook_endpoint}","href":"/api-reference/endpoints-de-webhook/atualizar-um-endpoint-de-webhook"},{"title":"Excluir um endpoint de webhook","deprecated":null,"version":null,"openapi":"/api/openapi.yaml delete /v1/webhook_endpoints/{webhook_endpoint}","href":"/api-reference/endpoints-de-webhook/excluir-um-endpoint-de-webhook"}]}]}]}]}]},"title":"Criar um endpoint de webhook - blü","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}