Atualizar template

PUT

{{baseURL}}/api/v3/settings/channels-gateway/manager/templates/{id}

Última modificação:2026-08-18 16:40:31

Atualiza um template existente. Alterações no conteúdo são reenviadas à Meta
e o modelo volta para análise.

Após a atualização o api-core invalida o cache local do template
(invalidateTemplateCache), então o novo conteúdo já vale para o próximo envio.

Use pra:

Corrigir um modelo reprovado e reenviar para análise

Ajustar descrição ou vínculos sem recriar o template

A Meta não permite mudar name, language nem category de um template já
aprovado — nesses casos, crie um modelo novo.

Este endpoint também atende RCS. Use channel=rcs e o contentType
correspondente (text, rich-card ou carousel) — o formato do content muda
conforme o tipo. Veja Configurações › Templates › RCS.

Requisição

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Exemplo

{
    "name": "continuacao_conversa",
    "channel": "whatsapp",
    "contentType": "hsm",
    "wabaId": "900000000000001",
    "appId": "800000000000001",
    "content": {
        "type": "hsm",
        "category": "marketing",
        "language": "pt_BR",
        "parameterFormat": "named",
        "components": [
            {
                "type": "body",
                "text": "Olá! Sou {{agente}} e vou seguir com o seu atendimento.",
                "variables": [
                    {
                        "parameterName": "agente",
                        "example": "João"
                    }
                ]
            }
        ]
    }
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff --request PUT 'https://api-{tenant}.digitalk.com.br/api/v3/settings/channels-gateway/manager/templates/d41a8c76-3b52-4e09-9f18-6c7b204ea351' \
--header 'api-key: API_TOKEN (disponível no database da plataforma)' \
--header 'Content-Type: application/json' \
--data '{
    "name": "continuacao_conversa",
    "channel": "whatsapp",
    "contentType": "hsm",
    "wabaId": "900000000000001",
    "appId": "800000000000001",
    "content": {
        "type": "hsm",
        "category": "marketing",
        "language": "pt_BR",
        "parameterFormat": "named",
        "components": [
            {
                "type": "body",
                "text": "Olá! Sou {{agente}} e vou seguir com o seu atendimento.",
                "variables": [
                    {
                        "parameterName": "agente",
                        "example": "João"
                    }
                ]
            }
        ]
    }
}'

Respostas

🟢202Aceite

application/json

Atualização aceita. O template volta para análise da Meta.

Bodyapplication/json

Exemplo

{
    "id": "d41a8c76-3b52-4e09-9f18-6c7b204ea351",
    "name": "continuacao_conversa",
    "description": null,
    "companyToken": "9f3c1a7e5d2b48c0a1e6f70b2c4d8e91",
    "externalId": "600000000000001",
    "appId": "800000000000001",
    "wabaId": "900000000000001",
    "status": "in-review",
    "channel": "whatsapp",
    "contentType": "hsm",
    "content": {
        "type": "hsm",
        "category": "marketing",
        "language": "pt_BR",
        "components": [
            {
                "text": "Olá! Tudo bem?\n\nMeu nome é {{agente}} e faço parte da equipe.\n\nA partir de agora, vou dar continuidade ao seu atendimento.\n\nPodemos continuar a conversa?",
                "type": "body",
                "variables": [
                    {
                        "example": "João",
                        "parameterName": "agente"
                    }
                ]
            }
        ],
        "parameterFormat": "named"
    },
    "variables": [
        {
            "type": "body",
            "default": "João",
            "parameterName": "agente"
        }
    ],
    "reason": null,
    "analytics": {},
    "activeAt": "2026-07-30T20:39:03.404Z",
    "archivedAt": null,
    "deletedAt": null,
    "inactiveAt": null,
    "inReviewAt": "2026-08-14T13:52:44.907Z",
    "rejectedAt": null,
    "flaggedAt": null,
    "pausedAt": null,
    "lockedAt": null,
    "inAppealAt": null,
    "limitExceededAt": null,
    "pendingDeletionAt": null,
    "reinstatedAt": null,
    "createdAt": "2026-07-30T20:30:31.938Z",
    "updatedAt": "2026-07-30T20:39:03.406Z",
    "wabaName": "Atendimento Comercial"
}

🟠400Pedido Inválido

🟠401Não Autorizado

🟠403Proibido

🟠404Registo Não Encontrado

Modificado em 2026-08-18 16:40:31