{
"error": {
"code": "invalid_request",
"message": "The request body is invalid. Check the details field and the API reference.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1",
"details": [
{
"path": "(root)",
"message": "send category and/or components"
}
]
}
}
{
"error": {
"code": "invalid_api_key",
"message": "Missing or invalid API key. Send it as 'Authorization: Bearer sk_...'.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
}
}
{
"error": {
"code": "template_not_found",
"message": "No template with this id exists in your WhatsApp Business Account.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
}
}
{
"error": {
"code": "template_status_conflict",
"message": "Templates with status PENDING cannot be edited. Only APPROVED, REJECTED or PAUSED templates accept edits.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
}
}
{
"error": {
"code": "template_invalid",
"message": "Meta refused this template definition. See details.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1",
"upstream_code": 100,
"details": [
{
"path": "meta",
"message": "O parâmetro \"components\" do modelo de mensagem não contém alguns campos esperados: o componente do tipo BODY não contém o(s) campo(s) esperado(s) (example)"
}
]
}
}
{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit for this API key exceeded. Retry after the time in the Retry-After header.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
}
}
Templates
Editar Template
Edita a categoria e/ou os componentes de um template. Envie pelo menos um dos dois.
componentssubstitui a lista inteira — a Meta não edita um componente isolado. Mande o template completo como deve ficar.
name e language são a identidade do template e não são editáveis; enviá-los retorna 400.
Só um componente HEADER por template; mais de um retorna 400.
Só templates APPROVED, REJECTED ou PAUSED aceitam edição. Em análise (PENDING), retorna 409 template_status_conflict.
Limites da Meta: um template aprovado aceita 1 edição a cada 24 horas e 10 em 30 dias, e a categoria de um aprovado não pode mudar. Recusados e pausados não têm limite.
A resposta traz o status relido na Meta depois da edição.
{
"error": {
"code": "invalid_request",
"message": "The request body is invalid. Check the details field and the API reference.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1",
"details": [
{
"path": "(root)",
"message": "send category and/or components"
}
]
}
}
{
"error": {
"code": "invalid_api_key",
"message": "Missing or invalid API key. Send it as 'Authorization: Bearer sk_...'.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
}
}
{
"error": {
"code": "template_not_found",
"message": "No template with this id exists in your WhatsApp Business Account.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
}
}
{
"error": {
"code": "template_status_conflict",
"message": "Templates with status PENDING cannot be edited. Only APPROVED, REJECTED or PAUSED templates accept edits.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
}
}
{
"error": {
"code": "template_invalid",
"message": "Meta refused this template definition. See details.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1",
"upstream_code": 100,
"details": [
{
"path": "meta",
"message": "O parâmetro \"components\" do modelo de mensagem não contém alguns campos esperados: o componente do tipo BODY não contém o(s) campo(s) esperado(s) (example)"
}
]
}
}
{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit for this API key exceeded. Retry after the time in the Retry-After header.",
"request_id": "req_01J9X7K2M3N4P5Q6R7S8T9V0W1"
}
}
Chave de API da sua empresa (sk_...). Crie no painel Superlead em Integrações → API e envie em toda chamada como Authorization: Bearer sk_.... Veja Autenticação.
Componentes do template no formato da Meta (HEADER, BODY, FOOTER, BUTTONS). Cada item precisa de type; o restante segue a documentação da Meta. Em cabeçalho de mídia, example.header_handle[0] aceita uma URL https pública do arquivo de exemplo.
Required array length: 1 - 10 elements
Show child attributes
Response
Template após a edição, com o status relido na Meta.
Status na Meta (APPROVED, PENDING, REJECTED, PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION...). Só APPROVED pode ser enviado. Valores novos podem surgir.
Estrutura do template (cabeçalho, corpo, rodapé, botões) no formato da Meta. Em cabeçalho de mídia, o exemplo volta como uma URL temporária da Meta.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Superlead","description":"API pública da Superlead para envio de mensagens WhatsApp e gestão de leads.","colors":{"primary":"#0E7A66","light":"#2BB597","dark":"#0E8F79"},"logo":{"light":"https://mintcdn.com/superlead/lAbwMrIKfewRNFRq/logo/light.svg?fit=max\u0026auto=format\u0026n=lAbwMrIKfewRNFRq\u0026q=85\u0026s=6ed7fc7c9bab87f5523f7d9ae92c7eff","dark":"https://mintcdn.com/superlead/lAbwMrIKfewRNFRq/logo/dark.svg?fit=max\u0026auto=format\u0026n=lAbwMrIKfewRNFRq\u0026q=85\u0026s=c9cd189b28820f7cde80f7e9c50249a4","href":"https://superlead.app"},"favicon":"https://mintcdn.com/superlead/lAbwMrIKfewRNFRq/favicon.png?fit=max\u0026auto=format\u0026n=lAbwMrIKfewRNFRq\u0026q=85\u0026s=e2d8fc30fdafb7a60c19af84ba48fdd3","api":{"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["bash","javascript","python"]}},"footer":{"socials":{"website":"https://superlead.app"}},"search":{"prompt":"Buscar na documentação..."},"fonts":{"heading":{"family":"Outfit"},"body":{"family":"Inter"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"superlead","hasAudioNarration":false,"actualSubdomain":"superlead","customDomains":["docs.superlead.app"],"gitSource":{"type":"github","owner":"kaique-grigoletto","repo":"superlead-2","deployBranch":"feat/webhook-saida-svix","contentDirectory":"mintlify","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"9a428529-d79f-46fa-944b-7a6b4be4b990","liveDeploymentHistoryId":"6ad7694f7895bb0f9a31de92","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad7694f7895bb0f9a31de92"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ad7694f7895bb0f9a31de92","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"Referência da API","count":14},{"language":"default","tag":"Documentação","count":10},{"language":"default","tag":"Conceitos","count":8},{"language":"default","tag":"Leads","count":5},{"language":"default","tag":"Templates","count":5},{"language":"default","tag":"Comece aqui","count":2},{"language":"default","tag":"WhatsApp","count":2},{"language":"default","tag":"Introdução","count":1},{"language":"default","tag":"Funil","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","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":"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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","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},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"#ask-assistant-code-block-button,#assistant-entry,#assistant-entry-mobile,#chat-assistant-sheet,#chat-assistant-textarea,[data-component-part=search-ask-ai-button],[data-component-part=search-ask-ai-item],[role=group]:has([data-component-part=search-ask-ai-item]),button[aria-label=\"Toggle assistant panel\"],div:has(>#chat-assistant-sheet),div:has(>div>#chat-assistant-textarea){display:none!important}button[aria-label=\"Preview Widget\"]{display:none!important}[data-component-part=field-required-pill]{font-size:0!important}[data-component-part=field-required-pill]::after{content:\"obrigatório\";font-size:.75rem;line-height:1rem}img.nav-logo{height:2.25rem!important}"}],"page":{"pagePath":"api-reference/editar-template","slug":"/api-reference/editar-template","pageMetadata":{"title":"Editar Template","description":"Edita a categoria e/ou os componentes de um template. Envie pelo menos um dos dois.\n\n- `components` **substitui a lista inteira** — a Meta não edita um componente isolado. Mande o template completo como deve ficar.\n- `name` e `language` são a identidade do template e **não são editáveis**; enviá-los retorna `400`.\n- Só um componente `HEADER` por template; mais de um retorna `400`.\n- Só templates `APPROVED`, `REJECTED` ou `PAUSED` aceitam edição. Em análise (`PENDING`), retorna `409 template_status_conflict`.\n- Limites da Meta: um template aprovado aceita 1 edição a cada 24 horas e 10 em 30 dias, e a categoria de um aprovado não pode mudar. Recusados e pausados não têm limite.\n- A resposta traz o **status relido na Meta** depois da edição.\n\nVeja o guia de [Templates](/guias/templates).","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/whatsapp/templates/{id}","href":"/api-reference/editar-template","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Edita a categoria e/ou os componentes de um template. Envie pelo menos um dos dois.\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"components\"\n }), \" \", _jsx(_components.strong, {\n children: \"substitui a lista inteira\"\n }), \" — a Meta não edita um componente isolado. Mande o template completo como deve ficar.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"name\"\n }), \" e \", _jsx(_components.code, {\n children: \"language\"\n }), \" são a identidade do template e \", _jsx(_components.strong, {\n children: \"não são editáveis\"\n }), \"; enviá-los retorna \", _jsx(_components.code, {\n children: \"400\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Só um componente \", _jsx(_components.code, {\n children: \"HEADER\"\n }), \" por template; mais de um retorna \", _jsx(_components.code, {\n children: \"400\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Só templates \", _jsx(_components.code, {\n children: \"APPROVED\"\n }), \", \", _jsx(_components.code, {\n children: \"REJECTED\"\n }), \" ou \", _jsx(_components.code, {\n children: \"PAUSED\"\n }), \" aceitam edição. Em análise (\", _jsx(_components.code, {\n children: \"PENDING\"\n }), \"), retorna \", _jsx(_components.code, {\n children: \"409 template_status_conflict\"\n }), \".\"]\n }), \"\\n\", _jsx(_components.li, {\n children: \"Limites da Meta: um template aprovado aceita 1 edição a cada 24 horas e 10 em 30 dias, e a categoria de um aprovado não pode mudar. Recusados e pausados não têm limite.\"\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"A resposta traz o \", _jsx(_components.strong, {\n children: \"status relido na Meta\"\n }), \" depois da edição.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Veja o guia de \", _jsx(_components.a, {\n href: \"/guias/templates\",\n children: \"Templates\"\n }), \".\"]\n })]\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":"Editar Template","description":"Edita a categoria e/ou os componentes de um template. Envie pelo menos um dos dois.\n\n- `components` **substitui a lista inteira** — a Meta não edita um componente isolado. Mande o template completo como deve ficar.\n- `name` e `language` são a identidade do template e **não são editáveis**; enviá-los retorna `400`.\n- Só um componente `HEADER` por template; mais de um retorna `400`.\n- Só templates `APPROVED`, `REJECTED` ou `PAUSED` aceitam edição. Em análise (`PENDING`), retorna `409 template_status_conflict`.\n- Limites da Meta: um template aprovado aceita 1 edição a cada 24 horas e 10 em 30 dias, e a categoria de um aprovado não pode mudar. Recusados e pausados não têm limite.\n- A resposta traz o **status relido na Meta** depois da edição.\n\nVeja o guia de [Templates](/guias/templates).","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/whatsapp/templates/{id}","href":"/api-reference/editar-template","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/superlead/25b2f7a78b2d28d5/script.js"],"openApiReferenceData":{"operation":{"operationId":"updateWhatsAppTemplate","summary":"Editar Template","description":"Edita a categoria e/ou os componentes de um template. Envie pelo menos um dos dois.\n\n- `components` **substitui a lista inteira** — a Meta não edita um componente isolado. Mande o template completo como deve ficar.\n- `name` e `language` são a identidade do template e **não são editáveis**; enviá-los retorna `400`.\n- Só um componente `HEADER` por template; mais de um retorna `400`.\n- Só templates `APPROVED`, `REJECTED` ou `PAUSED` aceitam edição. Em análise (`PENDING`), retorna `409 template_status_conflict`.\n- Limites da Meta: um template aprovado aceita 1 edição a cada 24 horas e 10 em 30 dias, e a categoria de um aprovado não pode mudar. Recusados e pausados não têm limite.\n- A resposta traz o **status relido na Meta** depois da edição.\n\nVeja o guia de [Templates](/guias/templates).","security":["aa30e4bd-4e69-4a07-b52a-694f02bdf372"],"parameters":["19ed276b-da6d-4905-9b51-faa87c6402f5"],"requestBody":"c3eb07c7-5867-49cc-8024-6fde8ce2b7b7","responses":{"200":"7669a38d-75aa-4b80-a51c-4fee8985ad9d","400":"c12dc3be-0d17-4a92-90e8-b66314414b4b","401":"cf2e850e-554f-40ad-8889-032b17d5fda7","404":"9a847137-ddd9-4764-aa2f-6bdd01c36538","409":"a153d69c-bcd4-43f1-9346-bcef12ef3034","422":"ecea6ab8-15ca-495b-a818-e54c3424f33c","429":"56015a01-d78f-4a80-8b8d-06041eecb83f"},"method":"patch","type":"path","servers":["3a775c26-798c-4eee-887e-ba104b2f983e"],"path":"/v1/whatsapp/templates/{id}","baseUrlOptions":["https://api.superlead.app"],"title":"Editar Template","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"19ed276b-da6d-4905-9b51-faa87c6402f5":{"name":"id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"Id do template (`tpl_...`), retornado na criação ou em `GET /v1/whatsapp/templates`.","uniqueKey":"","typeLabel":"string"},"description":"Id do template (`tpl_...`), retornado na criação ou em `GET /v1/whatsapp/templates`.","example":"tpl_1689556908129832"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"category":{"type":"string","enum":["MARKETING","UTILITY","AUTHENTICATION"],"description":"Nova categoria. Não pode mudar em template aprovado.","example":"UTILITY","uniqueKey":"category","typeLabel":"enum\u003cstring>"},"components":{"type":"array","minItems":1,"maxItems":10,"description":"Componentes do template no formato da Meta (`HEADER`, `BODY`, `FOOTER`, `BUTTONS`). Cada item precisa de `type`; o restante segue a documentação da Meta. Em cabeçalho de mídia, `example.header_handle[0]` aceita uma URL `https` pública do arquivo de exemplo.","items":{"type":"object","required":["type"],"additionalProperties":{"oneOf":[{}],"uniqueKey":"components.items.[INDEX].additionalProperties","typeLabel":"any"},"properties":{"type":{"type":"string","description":"Tipo do componente: `HEADER`, `BODY`, `FOOTER` ou `BUTTONS`.","example":"BODY","isRequired":true,"uniqueKey":"components.items.[INDEX].type","typeLabel":"string"}},"uniqueKey":"components.items.[INDEX]","typeLabel":"object"},"uniqueKey":"components","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"componentes":{"title":"componentes","value":{"components":[{"type":"BODY","text":"Olá {{1}}! Confirmamos sua consulta para {{2}}. Até lá!","example":{"body_text":[["Maria","12/10 às 14h"]]}}]}},"categoria":{"title":"categoria","value":{"category":"MARKETING"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"7669a38d-75aa-4b80-a51c-4fee8985ad9d":{"description":"Template após a edição, com o status relido na Meta.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Id do template (`tpl_...`). Use nas rotas `/v1/whatsapp/templates/{id}`.","example":"tpl_1689556908129832","uniqueKey":"id","typeLabel":"string"},"name":{"type":"string","description":"Nome do template — use como `template.name` no envio.","example":"confirmacao_consulta","uniqueKey":"name","typeLabel":"string"},"language":{"oneOf":[{"type":"string","description":"Código do idioma — use como `template.language.code` no envio.","example":"pt_BR","uniqueKey":"language.oneOf.0","typeLabel":"string"},{"type":"null","description":"Código do idioma — use como `template.language.code` no envio.","example":"pt_BR","uniqueKey":"language.oneOf.1","typeLabel":"null"}],"uniqueKey":"language","typeLabel":"string | null"},"category":{"oneOf":[{"type":"string","description":"Categoria atribuída pela Meta (`MARKETING`, `UTILITY`, `AUTHENTICATION`). Pode ser diferente da que você pediu.","example":"UTILITY","uniqueKey":"category.oneOf.0","typeLabel":"string"},{"type":"null","description":"Categoria atribuída pela Meta (`MARKETING`, `UTILITY`, `AUTHENTICATION`). Pode ser diferente da que você pediu.","example":"UTILITY","uniqueKey":"category.oneOf.1","typeLabel":"null"}],"uniqueKey":"category","typeLabel":"string | null"},"status":{"type":"string","description":"Status na Meta (`APPROVED`, `PENDING`, `REJECTED`, `PAUSED`, `DISABLED`, `IN_APPEAL`, `PENDING_DELETION`...). Só `APPROVED` pode ser enviado. Valores novos podem surgir.","example":"APPROVED","uniqueKey":"status","typeLabel":"string"},"parameter_format":{"oneOf":[{"type":"string","description":"Como as variáveis são escritas: `POSITIONAL` (`{{1}}`) ou `NAMED` (`{{nome}}`).","example":"POSITIONAL","uniqueKey":"parameter_format.oneOf.0","typeLabel":"string"},{"type":"null","description":"Como as variáveis são escritas: `POSITIONAL` (`{{1}}`) ou `NAMED` (`{{nome}}`).","example":"POSITIONAL","uniqueKey":"parameter_format.oneOf.1","typeLabel":"null"}],"uniqueKey":"parameter_format","typeLabel":"string | null"},"rejected_reason":{"oneOf":[{"type":"string","description":"Motivo informado pela Meta quando `status` é `REJECTED`; `null` nos demais casos.","example":null,"uniqueKey":"rejected_reason.oneOf.0","typeLabel":"string"},{"type":"null","description":"Motivo informado pela Meta quando `status` é `REJECTED`; `null` nos demais casos.","example":null,"uniqueKey":"rejected_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"rejected_reason","typeLabel":"string | null"},"components":{"oneOf":[{"type":"array","description":"Estrutura do template (cabeçalho, corpo, rodapé, botões) no formato da Meta. Em cabeçalho de mídia, o exemplo volta como uma URL temporária da Meta.","items":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"components.oneOf.0.items.[INDEX].additionalProperties","typeLabel":"any"},"uniqueKey":"components.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"components.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Estrutura do template (cabeçalho, corpo, rodapé, botões) no formato da Meta. Em cabeçalho de mídia, o exemplo volta como uma URL temporária da Meta.","items":{"type":"object","additionalProperties":{"oneOf":[{}]}},"uniqueKey":"components.oneOf.1","typeLabel":"null"}],"uniqueKey":"components","typeLabel":"object[] | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"tpl_1689556908129832","name":"confirmacao_consulta","language":"pt_BR","category":"UTILITY","status":"PENDING","parameter_format":"POSITIONAL","rejected_reason":null,"components":[{"type":"BODY","text":"Olá {{1}}! Sua consulta está confirmada para {{2}}.","example":{"body_text":[["Maria","12/10 às 14h"]]}}]},"examples":{"Example":{"title":"Example","value":{"id":"tpl_1689556908129832","name":"confirmacao_consulta","language":"pt_BR","category":"UTILITY","status":"PENDING","parameter_format":"POSITIONAL","rejected_reason":null,"components":[{"type":"BODY","text":"Olá {{1}}! Sua consulta está confirmada para {{2}}.","example":{"body_text":[["Maria","12/10 às 14h"]]}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"c12dc3be-0d17-4a92-90e8-b66314414b4b":{"description":"`invalid_request` — corpo fora do formato, vazio, ou com `name`/`language`.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Código estável do erro (ex.: `lead_not_found`). Novos códigos podem surgir a qualquer momento — trate códigos desconhecidos pelo HTTP status.","example":"lead_not_found","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Descrição legível do erro, em inglês. O texto pode mudar — não faça parsing dele; use `code`.","uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Id único desta requisição. Inclua ao reportar um problema ao suporte.","example":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1","uniqueKey":"error.request_id","typeLabel":"string"},"upstream_code":{"type":"number","description":"Código numérico original da Meta, presente quando o erro veio do WhatsApp (ex.: `131047` para fora da janela de 24h).","example":131047,"uniqueKey":"error.upstream_code","typeLabel":"number"},"details":{"type":"array","description":"Detalhes do erro. Aparece em três casos: erros de validação campo a campo em `400 invalid_request` (`path` é o campo do body); a explicação da Meta numa recusa de template, com `path: \"meta\"` (só quando a Meta envia uma explicação); e as campanhas que bloqueiam a exclusão de um template (`template_in_use`), com `path: \"campaigns\"` (até 10).","items":{"type":"object","properties":{"path":{"type":"string","description":"Em `invalid_request`, o caminho do campo inválido no body (ex.: `text.body`). Nas recusas de template vale `meta`; em `template_in_use` vale `campaigns`.","uniqueKey":"error.details.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","description":"O que está errado com o campo.","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_request","message":"The request body is invalid. Check the details field and the API reference.","request_id":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1","details":[{"path":"(root)","message":"send category and/or components"}]}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"The request body is invalid. Check the details field and the API reference.","request_id":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1","details":[{"path":"(root)","message":"send category and/or components"}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"cf2e850e-554f-40ad-8889-032b17d5fda7":{"description":"`invalid_api_key` — chave de API ausente, malformada ou revogada. Envie `Authorization: Bearer sk_...`.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Código estável do erro (ex.: `lead_not_found`). Novos códigos podem surgir a qualquer momento — trate códigos desconhecidos pelo HTTP status.","example":"lead_not_found","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Descrição legível do erro, em inglês. O texto pode mudar — não faça parsing dele; use `code`.","uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Id único desta requisição. Inclua ao reportar um problema ao suporte.","example":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1","uniqueKey":"error.request_id","typeLabel":"string"},"upstream_code":{"type":"number","description":"Código numérico original da Meta, presente quando o erro veio do WhatsApp (ex.: `131047` para fora da janela de 24h).","example":131047,"uniqueKey":"error.upstream_code","typeLabel":"number"},"details":{"type":"array","description":"Detalhes do erro. Aparece em três casos: erros de validação campo a campo em `400 invalid_request` (`path` é o campo do body); a explicação da Meta numa recusa de template, com `path: \"meta\"` (só quando a Meta envia uma explicação); e as campanhas que bloqueiam a exclusão de um template (`template_in_use`), com `path: \"campaigns\"` (até 10).","items":{"type":"object","properties":{"path":{"type":"string","description":"Em `invalid_request`, o caminho do campo inválido no body (ex.: `text.body`). Nas recusas de template vale `meta`; em `template_in_use` vale `campaigns`.","uniqueKey":"error.details.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","description":"O que está errado com o campo.","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_api_key","message":"Missing or invalid API key. Send it as 'Authorization: Bearer sk_...'.","request_id":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_api_key","message":"Missing or invalid API key. Send it as 'Authorization: Bearer sk_...'.","request_id":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1"}}}},"exampleType":"examples"}},"exampleType":"examples"},"9a847137-ddd9-4764-aa2f-6bdd01c36538":{"description":"`template_not_found` — nenhum template com este id na sua conta WhatsApp Business (um id fora do formato `tpl_\u003cnúmeros>` também retorna 404).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Código estável do erro (ex.: `lead_not_found`). Novos códigos podem surgir a qualquer momento — trate códigos desconhecidos pelo HTTP status.","example":"lead_not_found","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Descrição legível do erro, em inglês. O texto pode mudar — não faça parsing dele; use `code`.","uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Id único desta requisição. Inclua ao reportar um problema ao suporte.","example":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1","uniqueKey":"error.request_id","typeLabel":"string"},"upstream_code":{"type":"number","description":"Código numérico original da Meta, presente quando o erro veio do WhatsApp (ex.: `131047` para fora da janela de 24h).","example":131047,"uniqueKey":"error.upstream_code","typeLabel":"number"},"details":{"type":"array","description":"Detalhes do erro. Aparece em três casos: erros de validação campo a campo em `400 invalid_request` (`path` é o campo do body); a explicação da Meta numa recusa de template, com `path: \"meta\"` (só quando a Meta envia uma explicação); e as campanhas que bloqueiam a exclusão de um template (`template_in_use`), com `path: \"campaigns\"` (até 10).","items":{"type":"object","properties":{"path":{"type":"string","description":"Em `invalid_request`, o caminho do campo inválido no body (ex.: `text.body`). Nas recusas de template vale `meta`; em `template_in_use` vale `campaigns`.","uniqueKey":"error.details.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","description":"O que está errado com o campo.","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"template_not_found","message":"No template with this id exists in your WhatsApp Business Account.","request_id":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"template_not_found","message":"No template with this id exists in your WhatsApp Business Account.","request_id":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1"}}}},"exampleType":"examples"}},"exampleType":"examples"},"a153d69c-bcd4-43f1-9346-bcef12ef3034":{"description":"`template_status_conflict` — o status atual do template não permite edição (em análise, em recurso ou desabilitado).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Código estável do erro (ex.: `lead_not_found`). Novos códigos podem surgir a qualquer momento — trate códigos desconhecidos pelo HTTP status.","example":"lead_not_found","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Descrição legível do erro, em inglês. O texto pode mudar — não faça parsing dele; use `code`.","uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Id único desta requisição. Inclua ao reportar um problema ao suporte.","example":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1","uniqueKey":"error.request_id","typeLabel":"string"},"upstream_code":{"type":"number","description":"Código numérico original da Meta, presente quando o erro veio do WhatsApp (ex.: `131047` para fora da janela de 24h).","example":131047,"uniqueKey":"error.upstream_code","typeLabel":"number"},"details":{"type":"array","description":"Detalhes do erro. Aparece em três casos: erros de validação campo a campo em `400 invalid_request` (`path` é o campo do body); a explicação da Meta numa recusa de template, com `path: \"meta\"` (só quando a Meta envia uma explicação); e as campanhas que bloqueiam a exclusão de um template (`template_in_use`), com `path: \"campaigns\"` (até 10).","items":{"type":"object","properties":{"path":{"type":"string","description":"Em `invalid_request`, o caminho do campo inválido no body (ex.: `text.body`). Nas recusas de template vale `meta`; em `template_in_use` vale `campaigns`.","uniqueKey":"error.details.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","description":"O que está errado com o campo.","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"template_status_conflict","message":"Templates with status PENDING cannot be edited. Only APPROVED, REJECTED or PAUSED templates accept edits.","request_id":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"template_status_conflict","message":"Templates with status PENDING cannot be edited. Only APPROVED, REJECTED or PAUSED templates accept edits.","request_id":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1"}}}},"exampleType":"examples"}},"exampleType":"examples"},"ecea6ab8-15ca-495b-a818-e54c3424f33c":{"description":"`template_invalid` — a Meta recusou a edição (formato, limite de edições, categoria de aprovado); o motivo vem em `details`. `media_unsupported` — o arquivo de exemplo não pôde ser baixado. `no_active_connection`, `connection_expired`, `channel_capability_unsupported` — problemas da conexão WhatsApp.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Código estável do erro (ex.: `lead_not_found`). Novos códigos podem surgir a qualquer momento — trate códigos desconhecidos pelo HTTP status.","example":"lead_not_found","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Descrição legível do erro, em inglês. O texto pode mudar — não faça parsing dele; use `code`.","uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Id único desta requisição. Inclua ao reportar um problema ao suporte.","example":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1","uniqueKey":"error.request_id","typeLabel":"string"},"upstream_code":{"type":"number","description":"Código numérico original da Meta, presente quando o erro veio do WhatsApp (ex.: `131047` para fora da janela de 24h).","example":131047,"uniqueKey":"error.upstream_code","typeLabel":"number"},"details":{"type":"array","description":"Detalhes do erro. Aparece em três casos: erros de validação campo a campo em `400 invalid_request` (`path` é o campo do body); a explicação da Meta numa recusa de template, com `path: \"meta\"` (só quando a Meta envia uma explicação); e as campanhas que bloqueiam a exclusão de um template (`template_in_use`), com `path: \"campaigns\"` (até 10).","items":{"type":"object","properties":{"path":{"type":"string","description":"Em `invalid_request`, o caminho do campo inválido no body (ex.: `text.body`). Nas recusas de template vale `meta`; em `template_in_use` vale `campaigns`.","uniqueKey":"error.details.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","description":"O que está errado com o campo.","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"template_invalid","message":"Meta refused this template definition. See details.","request_id":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1","upstream_code":100,"details":[{"path":"meta","message":"O parâmetro \"components\" do modelo de mensagem não contém alguns campos esperados: o componente do tipo BODY não contém o(s) campo(s) esperado(s) (example)"}]}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"template_invalid","message":"Meta refused this template definition. See details.","request_id":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1","upstream_code":100,"details":[{"path":"meta","message":"O parâmetro \"components\" do modelo de mensagem não contém alguns campos esperados: o componente do tipo BODY não contém o(s) campo(s) esperado(s) (example)"}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"56015a01-d78f-4a80-8b8d-06041eecb83f":{"description":"`rate_limit_exceeded` — limite de 60 requisições/min da chave excedido (aguarde o `Retry-After`). `daily_quota_exceeded` — a cota diária da empresa acabou; zera à meia-noite de Brasília (aguarde o `Retry-After`). `channel_rate_limit` — a Meta está limitando a sua conta.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Código estável do erro (ex.: `lead_not_found`). Novos códigos podem surgir a qualquer momento — trate códigos desconhecidos pelo HTTP status.","example":"lead_not_found","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Descrição legível do erro, em inglês. O texto pode mudar — não faça parsing dele; use `code`.","uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Id único desta requisição. Inclua ao reportar um problema ao suporte.","example":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1","uniqueKey":"error.request_id","typeLabel":"string"},"upstream_code":{"type":"number","description":"Código numérico original da Meta, presente quando o erro veio do WhatsApp (ex.: `131047` para fora da janela de 24h).","example":131047,"uniqueKey":"error.upstream_code","typeLabel":"number"},"details":{"type":"array","description":"Detalhes do erro. Aparece em três casos: erros de validação campo a campo em `400 invalid_request` (`path` é o campo do body); a explicação da Meta numa recusa de template, com `path: \"meta\"` (só quando a Meta envia uma explicação); e as campanhas que bloqueiam a exclusão de um template (`template_in_use`), com `path: \"campaigns\"` (até 10).","items":{"type":"object","properties":{"path":{"type":"string","description":"Em `invalid_request`, o caminho do campo inválido no body (ex.: `text.body`). Nas recusas de template vale `meta`; em `template_in_use` vale `campaigns`.","uniqueKey":"error.details.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","description":"O que está errado com o campo.","uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"rate_limit_exceeded","message":"Rate limit for this API key exceeded. Retry after the time in the Retry-After header.","request_id":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limit_exceeded","message":"Rate limit for this API key exceeded. Retry after the time in the Retry-After header.","request_id":"req_01J9X7K2M3N4P5Q6R7S8T9V0W1"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"aa30e4bd-4e69-4a07-b52a-694f02bdf372":{"apiKey":{"type":"http","scheme":"bearer","description":"Chave de API da sua empresa (`sk_...`). Crie no painel Superlead em **Integrações → API** e envie em toda chamada como `Authorization: Bearer sk_...`. Veja [Autenticação](/guias/autenticacao).","scopes":[],"schemeName":"apiKey"}}},"servers":{"3a775c26-798c-4eee-887e-ba104b2f983e":{"url":"https://api.superlead.app","description":"Produção"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Chave de API da sua empresa (`sk_...`). Crie no painel Superlead em **Integrações → API** e envie em toda chamada como `Authorization: Bearer sk_...`. Veja [Autenticação](/guias/autenticacao).","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Chave de API da sua empresa (`sk_...`). Crie no painel Superlead em **Integrações → API** e envie em toda chamada como `Authorization: Bearer sk_...`. Veja [Autenticação](/guias/autenticacao).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"superlead","siteName":"Superlead","title":"Editar Template - Superlead","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-20T13:15:00.801Z","originalFileLocation":"api-reference/editar-template.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=\"Edita a categoria e/ou os componentes de um template. Envie pelo menos um dos dois. - components substitui a lista inteira — a Meta não edita um componente isolado. Mande o template completo como deve ficar. - name e language são a identidade do template e não são editáveis; enviá-los retorna 400. - Só um componente HEADER por template; mais de um retorna 400. - Só templates APPROVED, REJECTED ou PAUSED aceitam edição. Em análise (PENDING), retorna 409 template_status_conflict. - Limites da Meta: um template aprovado aceita 1 edição a cada 24 horas e 10 em 30 dias, e a categoria de um aprovado não pode mudar. Recusados e pausados não têm limite. - A resposta traz o status relido na Meta depois da edição. Veja o guia de Templates.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Superlead\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/superlead/0daKLFNz1QdqIPeS/_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/superlead/0daKLFNz1QdqIPeS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/superlead/0daKLFNz1QdqIPeS/_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/superlead/0daKLFNz1QdqIPeS/_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/superlead/0daKLFNz1QdqIPeS/_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/superlead/0daKLFNz1QdqIPeS/_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/superlead/0daKLFNz1QdqIPeS/_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/superlead/0daKLFNz1QdqIPeS/_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/superlead/0daKLFNz1QdqIPeS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Editar Template - Superlead\">\u003cmeta data-mint-head property=\"og:description\" content=\"Edita a categoria e/ou os componentes de um template. Envie pelo menos um dos dois. - components substitui a lista inteira — a Meta não edita um componente isolado. Mande o template completo como deve ficar. - name e language são a identidade do template e não são editáveis; enviá-los retorna 400. - Só um componente HEADER por template; mais de um retorna 400. - Só templates APPROVED, REJECTED ou PAUSED aceitam edição. Em análise (PENDING), retorna 409 template_status_conflict. - Limites da Meta: um template aprovado aceita 1 edição a cada 24 horas e 10 em 30 dias, e a categoria de um aprovado não pode mudar. Recusados e pausados não têm limite. - A resposta traz o status relido na Meta depois da edição. Veja o guia de Templates.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Superlead\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.superlead.app/api-reference/editar-template\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://superlead.mintlify.app/_mintlify/api/og/v2?division=Templates\u0026amp;title=Editar+Template\u0026amp;description=Edita+a+categoria+e%2Fou+os+componentes+de+um+template.+Envie+pelo+menos+um+dos+dois.%0A%0A-+%60components%60+**substitui+a+lista+inteira**+%E2%80%94+a+Meta+n%C3%A3o+edita+um+componen\u0026amp;theme=fbae094d518bcaff4ff0ada0\u0026amp;signature=77135756f1dd8d0da9bc0c2f38e6e6bbadcc909ff00cb0311068806dd9416df7\">\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=\"Editar Template - Superlead\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Edita a categoria e/ou os componentes de um template. Envie pelo menos um dos dois. - components substitui a lista inteira — a Meta não edita um componente isolado. Mande o template completo como deve ficar. - name e language são a identidade do template e não são editáveis; enviá-los retorna 400. - Só um componente HEADER por template; mais de um retorna 400. - Só templates APPROVED, REJECTED ou PAUSED aceitam edição. Em análise (PENDING), retorna 409 template_status_conflict. - Limites da Meta: um template aprovado aceita 1 edição a cada 24 horas e 10 em 30 dias, e a categoria de um aprovado não pode mudar. Recusados e pausados não têm limite. - A resposta traz o status relido na Meta depois da edição. Veja o guia de Templates.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://superlead.mintlify.app/_mintlify/api/og/v2?division=Templates\u0026amp;title=Editar+Template\u0026amp;description=Edita+a+categoria+e%2Fou+os+componentes+de+um+template.+Envie+pelo+menos+um+dos+dois.%0A%0A-+%60components%60+**substitui+a+lista+inteira**+%E2%80%94+a+Meta+n%C3%A3o+edita+um+componen\u0026amp;theme=fbae094d518bcaff4ff0ada0\u0026amp;signature=77135756f1dd8d0da9bc0c2f38e6e6bbadcc909ff00cb0311068806dd9416df7\">\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/superlead/0daKLFNz1QdqIPeS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Superlead\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0E7A66\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.superlead.app/api-reference/editar-template\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/editar-template.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.superlead.app/#organization\",\"name\":\"Superlead\",\"url\":\"https://docs.superlead.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/superlead/lAbwMrIKfewRNFRq/logo/light.svg?fit=max\u0026auto=format\u0026n=lAbwMrIKfewRNFRq\u0026q=85\u0026s=6ed7fc7c9bab87f5523f7d9ae92c7eff\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.superlead.app#website\",\"name\":\"Superlead\",\"url\":\"https://docs.superlead.app\",\"publisher\":{\"@id\":\"https://docs.superlead.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.superlead.app/api-reference/editar-template#webpage\",\"url\":\"https://docs.superlead.app/api-reference/editar-template\",\"name\":\"Editar Template\",\"description\":\"Edita a categoria e/ou os componentes de um template. Envie pelo menos um dos dois. - components substitui a lista inteira — a Meta não edita um componente isolado. Mande o template completo como deve ficar. - name e language são a identidade do template e não são editáveis; enviá-los retorna 400. - Só um componente HEADER por template; mais de um retorna 400. - Só templates APPROVED, REJECTED ou PAUSED aceitam edição. Em análise (PENDING), retorna 409 template_status_conflict. - Limites da Meta: um template aprovado aceita 1 edição a cada 24 horas e 10 em 30 dias, e a categoria de um aprovado não pode mudar. Recusados e pausados não têm limite. - A resposta traz o status relido na Meta depois da edição. Veja o guia de Templates.\",\"dateModified\":\"2026-10-20T13:15:00.801Z\",\"isPartOf\":{\"@id\":\"https://docs.superlead.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.superlead.app/api-reference/editar-template#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.superlead.app/api-reference/editar-template#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Templates\",\"item\":\"https://docs.superlead.app/api-reference/listar-templates\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Editar Template\",\"item\":\"https://docs.superlead.app/api-reference/editar-template\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.superlead.app/api-reference/editar-template#apireference\",\"headline\":\"Editar Template\",\"name\":\"Editar Template\",\"description\":\"Edita a categoria e/ou os componentes de um template. Envie pelo menos um dos dois. - components substitui a lista inteira — a Meta não edita um componente isolado. Mande o template completo como deve ficar. - name e language são a identidade do template e não são editáveis; enviá-los retorna 400. - Só um componente HEADER por template; mais de um retorna 400. - Só templates APPROVED, REJECTED ou PAUSED aceitam edição. Em análise (PENDING), retorna 409 template_status_conflict. - Limites da Meta: um template aprovado aceita 1 edição a cada 24 horas e 10 em 30 dias, e a categoria de um aprovado não pode mudar. Recusados e pausados não têm limite. - A resposta traz o status relido na Meta depois da edição. Veja o guia de Templates.\",\"url\":\"https://docs.superlead.app/api-reference/editar-template\",\"mainEntityOfPage\":{\"@id\":\"https://docs.superlead.app/api-reference/editar-template#webpage\"},\"dateModified\":\"2026-10-20T13:15:00.801Z\",\"publisher\":{\"@id\":\"https://docs.superlead.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.superlead.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Superlead\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Superlead","nav":{"global":null,"tabs":[{"tab":"Documentação","pages":[{"title":"Documentação","href":""}]},{"tab":"Referência da API","groups":[{"group":"Introdução","pages":[{"title":"Visão geral da referência","sidebarTitle":"Visão geral","href":"/referencia/visao-geral"}]},{"group":"WhatsApp","pages":[{"title":"Enviar Mensagem","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/whatsapp/messages","href":"/api-reference/enviar-mensagem"},{"title":"Consultar Mensagem","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/whatsapp/messages/{id}","href":"/api-reference/consultar-mensagem"}]},{"group":"Templates","pages":[{"title":"Listar Templates","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/whatsapp/templates","href":"/api-reference/listar-templates"},{"title":"Criar Template","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/whatsapp/templates","href":"/api-reference/criar-template"},{"title":"Consultar Template","description":"Retorna um template com o estado **atual na Meta**: status de aprovação, categoria, motivo da recusa e componentes.\n\nUse para acompanhar a aprovação depois de criar ou editar. Para ser avisado em vez de consultar, assine o webhook `whatsapp.template.updated` — veja [Webhooks](/guias/webhooks).","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/whatsapp/templates/{id}","href":"/api-reference/consultar-template"},{"title":"Editar Template","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/whatsapp/templates/{id}","href":"/api-reference/editar-template"},{"title":"Excluir Template","description":"Exclui o template deste id — **só este idioma**; versões do mesmo nome em outros idiomas continuam.\n\n- A exclusão é **bloqueada** enquanto houver campanha agendada, em andamento ou pausada usando o template (`409 template_in_use`, com até 10 campanhas em `details`).\n- A Meta impede recriar por **30 dias** o nome de um template aprovado que foi excluído.\n- Mensagens já enviadas e ainda não entregues continuam sendo tentadas pela Meta; nesse período o template pode aparecer com `status: \"PENDING_DELETION\"`.\n- Template desabilitado pela Meta não pode ser excluído (`409 template_status_conflict`).\n\nA exclusão não pode ser desfeita.","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/whatsapp/templates/{id}","href":"/api-reference/excluir-template"}]},{"group":"Leads","pages":[{"title":"Criar Lead","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/leads","href":"/api-reference/criar-lead"},{"title":"Buscar ou Listar Leads","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/leads","href":"/api-reference/buscar-ou-listar-leads"},{"title":"Buscar Lead por ID","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/leads/{id}","href":"/api-reference/buscar-lead-por-id"},{"title":"Editar Lead","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/leads/{id}","href":"/api-reference/editar-lead"},{"title":"Mover Lead de Etapa","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/leads/{id}/stage","href":"/api-reference/mover-lead-de-etapa"}]},{"group":"Funil","pages":[{"title":"Listar Etapas do Funil","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/funnel/stages","href":"/api-reference/listar-etapas-do-funil"}]}]}]},"basePath":"","title":"Editar Template - Superlead","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}