> ## Documentation Index > Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt > Use this file to discover all available pages before exploring further. # Melhores práticas do Direct Send > Envie conteúdo de utilidade ou converta um modelo existente com o Direct Send e, em seguida, monitore os modelos gerados e a qualidade do conteúdo. O Direct Send permite que empresas qualificadas enviem mensagens de Utilidade enviando o conteúdo completo ou reutilizando um modelo de mensagem de Utilidade existente. A Meta cuida da correspondência e geração de modelos para conteúdos personalizados. Este guia aborda o Direct Send de Utilidade por meio da YCloud. Para envio geral de mensagens, consulte [Enviar uma mensagem do WhatsApp](/pt/api-reference/guides/whatsapp-platform/send-whatsapp-message). ## Como funciona o Direct Send O Direct Send usa modelos nos bastidores. Você pode enviar texto finalizado ou conteúdo interativo. Você também pode referenciar um modelo de mensagem de Utilidade existente e solicitar que a YCloud converta seus componentes suportados em uma mensagem Direct Send. | Ponto de partida | Solicitação | O que a YCloud envia | | - | - | - | | Conteúdo completo de Utilidade | Defina `type` como `text` ou `interactive` e `category` como `utility`. | Seu conteúdo como uma mensagem Direct Send. | | Modelo de mensagem de Utilidade existente | Defina `type` como `template`, forneça `template.name`, `template.language` e todos os parâmetros obrigatórios e, em seguida, defina `useDirectSend: true`. | Conteúdo de texto convertido, URL de CTA ou botão de resposta. | A Meta compara o conteúdo da sua mensagem com um modelo existente. Se não houver correspondência, a Meta remove informações de identificação pessoal, detecta o idioma e gera um novo modelo em segundo plano para futuras mensagens correspondentes. Por exemplo, “Seu pedido A123456 foi enviado” e “Seu pedido B789012 foi enviado” compartilham a mesma estrutura. Notificações posteriores podem reutilizar um modelo gerado correspondente. Os modelos gerados mantêm informações de categoria, qualidade e desempenho. Isso permite identificar qual conteúdo está apresentando bom desempenho ou causando problemas de entrega, mesmo que você não tenha criado o modelo diretamente. ## Recursos suportados e limites ### Elegibilidade e escopo de envio Conecte sua WABA e número de telefone comercial à YCloud. Em **Gerenciador do WhatsApp da Meta → Modelos de mensagem**, verifique se sua empresa é elegível para o Direct Send. Se o acesso não estiver disponível para a sua WABA, use um modelo de mensagem de Utilidade aprovado ou entre em contato com a YCloud para verificar a elegibilidade. O Direct Send de Utilidade pode iniciar uma notificação esperada fora da janela de atendimento ao cliente de 24 horas. Obtenha a permissão do cliente e mantenha o conteúdo vinculado à solicitação, transação, conta ou informações essenciais qualificadas dele. Promoções e códigos de verificação estão fora deste fluxo de trabalho de Utilidade. | Recurso | Comportamento | | - | - | | Conteúdo da mensagem | Envie texto completo e conteúdo de botão suportado sem criar previamente um modelo. | | Modelo de mensagem de Utilidade existente | Defina `useDirectSend: true` para converter componentes suportados do modelo após fornecer seus parâmetros. | | Criação de modelo | A Meta faz a correspondência com um modelo gerado existente ou gera um novo em segundo plano. | | Envio | Use o envio enfileirado ou síncrono por meio da YCloud. | | Tempo de vida da entrega | Defina um `ttlSeconds` personalizado para notificações urgentes. | | Gerenciamento de modelos | Visualize modelos gerados na YCloud. Altere conteúdos futuros em sua solicitação de API. | | Preços | As [regras de preços de mensagens de Utilidade](/pt/documentation/whatsapp-business-platform/pricing-limits-and-quality/whatsapp-pricing) se aplicam. | ### Tamanho da mensagem e botões | Conteúdo | Limite | | - | - | | Corpo | 1.024 caracteres | | Cabeçalho | 60 caracteres | | Rodapé | 60 caracteres | | Rótulo do botão | 20 caracteres | | Formato de botão de resposta (`interactive.type: button`) | Até 3 botões de resposta | | Formato de botão de URL (`interactive.type: cta_url`) | 1 botão de URL | Os exemplos de envio abaixo usam cabeçalhos de texto. Mensagens de texto não exibem prévias de URL. Limites de conta e [controles de taxa de transferência](/pt/documentation/whatsapp-business-platform/pricing-limits-and-quality/messaging-limits-and-throughput) ainda se aplicam. Use cabeçalhos de texto para solicitações de Direct Send `interactive` personalizadas. Um cabeçalho de imagem está disponível apenas quando você converte um modelo suportado e a Meta habilitou esse recurso para a sua WABA. ### Tempo de vida da entrega (TTL) `ttlSeconds` define por quanto tempo uma mensagem pode permanecer elegível para entrega. Se ela não puder ser entregue dentro desse período, será descartada. Uma mensagem entregue não é excluída quando seu TTL expira. | Configuração | Valor de Utilidade | | - | - | | Padrão quando omitido | 30 dias | | TTL personalizado mínimo | 30 segundos | | TTL personalizado máximo | 43.200 segundos (12 horas) | O intervalo padrão e o intervalo personalizado permitido diferem. Para uma atualização de entrega que seja útil por apenas 30 minutos, defina `ttlSeconds: 1800`; não a deixe no padrão. ## Tipos de mensagens compatíveis Os formatos a seguir abrangem notificações de texto, links e respostas de clientes por meio da YCloud. | Tipo | Campos da requisição | Uso comum | | - | - | - | | Texto | `type: text`, com `text.body` | Confirmar um pedido ou informar uma alteração de status. | | Botão de URL | `type: interactive`, com `interactive.type: cta_url` | Abrir uma página de rastreamento, fatura ou agendamento. | | Botões de resposta | `type: interactive`, com `interactive.type: button` | Pedir para o cliente confirmar ou solicitar ajuda no WhatsApp. | Um botão de URL abre um site. Um botão de resposta envia a resposta selecionada de volta para a sua empresa, permitindo que a aplicação continue o fluxo de trabalho. ### Tratar respostas de botões de resposta Embora você envie uma requisição `interactive`, o Direct Send entrega o conteúdo como um modelo. O toque de um cliente no botão de resposta, portanto, utiliza o formato de resposta rápida de modelo: `type: button`, com `button.payload` e `button.text`. Campos relevantes em um evento de mensagem recebida da YCloud: ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "type": "whatsapp.inbound_message.received", "whatsappInboundMessage": { "type": "button", "button": { "payload": "delivery_help_A123456", "text": "I need help" }, "context": { "id": "ORIGINAL_MESSAGE_WAMID" } } } ``` Use `button.payload` para identificar a ação e `context.id` para correlacionar a resposta com o `wamid` da mensagem original. Não leia essa resposta em `interactive.button_reply`, que é o formato padrão de botão de resposta em formato livre. ## Enviar por meio da YCloud Prepare uma chave de API do lado do servidor e os números do remetente e do destinatário no formato E.164. Você só precisará do ID da WABA se optar por enviar amostras de mensagens. ### 1. Escolha o modo de envio | Endpoint | Comportamento | | - | - | | `POST /v2/whatsapp/messages` | Enfileira a mensagem e a envia de forma assíncrona. | | `POST /v2/whatsapp/messages/sendDirectly` | Envia a mensagem de forma síncrona para a WhatsApp Business API. | O nome do endpoint `sendDirectly` descreve a temporização do envio. Para usar o Direct Send, sua WABA deve ter acesso e sua requisição deve incluir os campos do Direct Send abaixo. ### 2. Construa a requisição | Campo | Valor ou finalidade | | - | - | | `from`, `to` | Números do remetente e destinatário no formato E.164. | | `type` | `text` ou `interactive`. | | `text` ou `interactive` | O conteúdo completo da mensagem. | | `category` | `utility`. | | `useDirectSend` | Defina como `true` ao converter um modelo existente. É opcional para conteúdo personalizado com `category: "utility"`. | | `ttlSeconds` | Tempo de vida de entrega (TTL) opcional em segundos. | | `externalId` | Referência de negócios opcional para conciliação; não garante idempotência. | Estes exemplos enviam o conteúdo completo de forma síncrona. Você também pode usar um envio enfileirado ou [converter um modelo existente de Utilidade](#convert-an-existing-utility-template). Substitua os marcadores de número de telefone e o URL de exemplo antes de enviar. ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} curl --request POST \ 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \ --header 'Content-Type: application/json' \ --header "X-API-Key: ${YCLOUD_API_KEY}" \ --data '{ "from": "BUSINESS_PHONE_NUMBER", "to": "CUSTOMER_PHONE_NUMBER", "type": "text", "text": { "body": "Your order A123456 has shipped. Your estimated delivery date is September 15." }, "category": "utility", "useDirectSend": true, "ttlSeconds": 1800, "externalId": "order-A123456-shipped-text" }' ``` ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} curl --request POST \ 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \ --header 'Content-Type: application/json' \ --header "X-API-Key: ${YCLOUD_API_KEY}" \ --data '{ "from": "BUSINESS_PHONE_NUMBER", "to": "CUSTOMER_PHONE_NUMBER", "type": "interactive", "interactive": { "type": "cta_url", "header": { "type": "text", "text": "Order shipped" }, "body": { "text": "Your order A123456 has shipped. View its latest delivery status below." }, "footer": { "text": "Order A123456" }, "action": { "name": "cta_url", "parameters": { "display_text": "Track order", "url": "https://example.com/orders/A123456" } } }, "category": "utility", "useDirectSend": true, "ttlSeconds": 1800, "externalId": "order-A123456-shipped-url" }' ``` ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} curl --request POST \ 'https://api.ycloud.com/v2/whatsapp/messages/sendDirectly' \ --header 'Content-Type: application/json' \ --header "X-API-Key: ${YCLOUD_API_KEY}" \ --data '{ "from": "BUSINESS_PHONE_NUMBER", "to": "CUSTOMER_PHONE_NUMBER", "type": "interactive", "interactive": { "type": "button", "header": { "type": "text", "text": "Delivery update" }, "body": { "text": "Your order A123456 is scheduled for delivery on September 15. Do you need help with this delivery?" }, "footer": { "text": "Order A123456" }, "action": { "buttons": [ { "type": "reply", "reply": { "id": "delivery_help_A123456", "title": "I need help" } }, { "type": "reply", "reply": { "id": "delivery_ok_A123456", "title": "No help needed" } } ] } }, "category": "utility", "useDirectSend": true, "ttlSeconds": 1800, "externalId": "order-A123456-delivery-reply" }' ``` ### 3. Rastreie a entrega Salve o `id` da mensagem retornado, o seu `externalId` e o `wamid` quando disponível. Receba atualizações por meio de `whatsapp.message.updated` ou consulte `GET /v2/whatsapp/messages/{id}`. Após `accepted`, o resultado do envio é `sent` ou `failed`. Mensagens bem-sucedidas podem avançar para `delivered` e `read`. Uma requisição aceita não é uma confirmação de entrega. Para erros de envio síncrono, inspecione `error.whatsappApiError` quando presente. Para mensagens enfileiradas, inspecione as atualizações de status subsequentes. Se uma requisição expirar (timeout), faça a conciliação da mensagem original antes de tentar novamente. ## Converter um modelo existente de Utilidade Use um modelo de Utilidade existente em sua WABA. Defina `type: "template"` e `useDirectSend: true`. Forneça o nome do modelo, o idioma e todos os parâmetros obrigatórios. A YCloud substitui as variáveis e converte os componentes compatíveis em texto ou conteúdo interativo com `category: "utility"`. O modelo deve atender aos limites de conversão abaixo. A YCloud não exige o status `APPROVED` para esta conversão. Se o modelo tiver um cabeçalho de imagem, confirme se a Meta habilitou o Direct Send com cabeçalho de imagem para a sua WABA antes de usá-lo. Isso requer acesso separado da Meta. Para este exemplo, use um modelo de utilidade existente chamado `order_update` com o corpo `Your order {{1}} has been updated.` e sem cabeçalho, rodapé ou botões: ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} curl --request POST https://api.ycloud.com/v2/whatsapp/messages/sendDirectly \ --header "X-API-Key: $YCLOUD_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "from": "+16315551111", "to": "+16315552222", "type": "template", "template": { "name": "order_update", "language": { "code": "en_US", "policy": "deterministic" }, "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "A123456" } ] } ] }, "useDirectSend": true, "ttlSeconds": 600 }' ``` A resposta contém o conteúdo convertido. Para este exemplo, `type` torna-se `text`, e a variável do modelo passa a ser o ID do pedido fornecido: ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "id": "MESSAGE_ID", "wabaId": "WHATSAPP_BUSINESS_ACCOUNT_ID", "from": "+16315551111", "to": "+16315552222", "type": "text", "text": { "body": "Your order A123456 has been updated." }, "status": "accepted", "category": "utility", "ttlSeconds": 600, "createTime": "2026-09-17T08:00:00.000Z" } ``` Uma resposta `accepted` não confirma a entrega. Armazene o `id` da mensagem e rastreie os eventos de `whatsapp.message.updated`. Revise os limites de conversão abaixo antes de reutilizar um modelo com cabeçalhos ou botões. Se a YCloud retornar `WHATSAPP_DIRECT_SEND_UNSUPPORTED_COMPONENT`, verifique o cabeçalho, os botões e as variáveis não resolvidas do modelo em relação aos limites abaixo. Se a WABA não puder usar o Direct Send, verifique sua elegibilidade antes de tentar novamente ou envie um modelo de utilidade aprovado pelo fluxo de trabalho comum de modelos. ### Definir o tempo de vida da mensagem Para a conversão de modelos, o valor de `ttlSeconds` na requisição tem precedência sobre o TTL do modelo. Se você omiti-lo, a YCloud herdará um TTL positivo do modelo de até `43200` segundos. Um TTL de modelo inferior a `30` segundos falhará na validação, portanto, substitua-o por um valor de requisição válido. A YCloud não herda valores de TTL de modelo acima de `43200`. Se nenhum dos valores for aplicável, a Meta usará o TTL padrão dela. ## Nomear um modelo de utilidade do Direct Send `template.name` identifica um modelo existente na requisição de conversão acima. `templateName` tem uma finalidade diferente: defina-o quando quiser que a Meta reutilize um nome reconhecível para um modelo de utilidade do Direct Send. O campo é opcional e não habilita o Direct Send por si só. Você também deve definir `useDirectSend: true` ou `category: "utility"`. ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "from": "+16315551111", "to": "+16315552222", "type": "text", "text": { "body": "Your order 12131123 has been placed at the door." }, "category": "utility", "templateName": "order_update_ds" } ``` O nome diferencia maiúsculas de minúsculas. Use de 1 a 512 letras minúsculas, dígitos ou sublinhados. A YCloud rejeita letras maiúsculas, espaços e outros caracteres. A mesma WABA não pode usar um nome que pertença a um modelo de mensagem regular existente do WhatsApp, incluindo um modelo rejeitado. A YCloud verifica isso antes de uma chamada síncrona ao provedor ou antes de aceitar uma mensagem enfileirada. Modelos excluídos não reservam o nome, e você pode reutilizar um nome gerado anteriormente pela Meta para o Direct Send. Se um modelo comum já estiver usando o nome, a API retornará HTTP `400` com target `templateName` e mensagem `A template with the same name already exists.` Escolha outro nome antes de tentar novamente. `templateName` não é suportado para Authentication Direct Send. Para uma mensagem de utilidade do Direct Send enfileirada, a YCloud retorna o erro de validação sem retornar um ID de mensagem e, caso contrário, encaminha o nome para a Meta sem armazená-lo no registro da mensagem. A YCloud ignora o campo para mensagens que não usam o Direct Send. ## Limites de conversão de modelo e de idioma O Direct Send de utilidade suporta texto, botões de URL de CTA e botões de resposta. Estes limites também se aplicam quando a YCloud converte um modelo de utilidade: | Conteúdo ou componente | Limite e comportamento de conversão | | - | - | | Corpo | Máximo de 1.024 caracteres. Forneça todas as variáveis do modelo. O Direct Send não exibe prévias de URL; omita `preview_url`. | | Cabeçalho de texto | Máximo de 60 caracteres. Com botões, torna-se o cabeçalho de texto interativo. Sem botões, a YCloud une o cabeçalho e o corpo em uma mensagem de texto. | | Cabeçalho de imagem | Requer um botão de URL de CTA ou de resposta. Forneça um parâmetro `image.link` ou `image.id`. Um cabeçalho de imagem sem botões não pode ser convertido. | | Rodapé | Máximo de 60 caracteres. A YCloud o inclui em mensagens interativas e o omite ao converter um modelo sem botões em texto. | | Botão de URL de CTA | Máximo de um. A YCloud converte um botão `URL` do modelo em `interactive.cta_url`. | | Botões de resposta | Máximo de três. A YCloud converte botões `QUICK_REPLY` do modelo em `interactive.button`. | | Rótulo do botão | Máximo de 20 caracteres. | Não combine botões de URL de CTA e de resposta rápida. Outros tipos de cabeçalho e botão não podem ser convertidos. Componentes incompatíveis ou variáveis de modelo não resolvidas retornam HTTP `400` com o código `WHATSAPP_DIRECT_SEND_UNSUPPORTED_COMPONENT`. ### Suporte a idiomas O Direct Send suporta os [idiomas de modelo do WhatsApp](/pt/api-reference/guides/whatsapp-platform/supported-whatsapp-template-languages), exceto: | Idioma | Código | | - | - | | Chinês, Simplificado | `zh_CN` | | Chinês, Hong Kong | `zh_HK` | | Chinês, Taiwan | `zh_TW` | | Japonês | `ja` | | Coreano | `ko` | | Tailandês | `th` | | Laosiano | `lo` | Use um idioma suportado para fluxos de trabalho do Direct Send. ## Visualizar modelos gerados pelo Direct Send na YCloud 1. Abra **WhatsApp Manager → Templates** no console da YCloud. 2. Selecione a WABA usada para enviar a mensagem. 3. Defina **Creator → Auto generated**. Use **Category → Utility** para restringir a lista aos modelos de utilidade. 4. Verifique o nome, a categoria, o idioma, o status e o horário da última atualização do modelo. Clique em seu nome ou em **Insights** para abrir sua pré-visualização e detalhes de desempenho. Filtro Creator definido como Auto generated em Templates Nomes de modelos gerados por conteúdo geralmente começam com `auto_generated`. Use o filtro **Auto generated** para identificá-los em vez de depender apenas de seus nomes. A página de insights mostra a prévia da mensagem e as estatísticas disponíveis de entrega, falha, leitura e interação para o período selecionado. Use o status e o conteúdo do modelo em conjunto ao investigar um aviso ou um modelo pausado. Modelos gerados não podem ser editados ou excluídos manualmente. Para alterar a notificação, mude o conteúdo em sua solicitação de envio; a Meta então fará a correspondência ou gerará um modelo para esse conteúdo. ## Diretrizes de integridade e conteúdo ### Mantenha o conteúdo de Utilidade específico e não promocional Mensagens de utilidade devem acompanhar uma ação esperada do cliente ou fornecer informações essenciais qualificadas. Indique o pedido, agendamento, conta ou transação relevante com clareza. | Conteúdo apropriado de Utilidade | Conteúdo a ser mantido fora deste fluxo de trabalho | | - | - | | “Seu pedido A123456 foi enviado.” | “Seu pedido foi enviado. Compre novamente hoje com 20% de desconto.” | | “Seu agendamento está confirmado para 15 de setembro às 10:00.” | “Agende outro horário agora e receba um brinde.” | | “Seu reembolso para o pedido A123456 foi processado.” | Uma promoção geral ou um código de verificação de identidade. | Alterar `category` para `utility` não muda o significado do conteúdo. A Meta continua avaliando os modelos gerados após o envio. Você pode verificar um caso de uso materialmente diferente com uma amostra de mensagem antes de enviar. ### Verificar um novo caso de uso com amostras de mensagem (opcional) `POST /v2/whatsapp/messages/{wabaId}/messageSamples` envia um exemplo para a Meta e retorna a categoria que a Meta detecta. Isso não envia uma mensagem para o cliente. Esta verificação é opcional; você não precisa chamá-la para cada mensagem ou antes de usar o Direct Send. Para um novo caso de uso de Utilidade, recomendamos verificar três ou quatro amostras representativas, uma por solicitação. Substitua `WABA_ID` pelo ID da sua conta do WhatsApp Business e defina `YCLOUD_API_KEY` no seu ambiente. Use detalhes fictícios de clientes na amostra: ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} curl --request POST \ 'https://api.ycloud.com/v2/whatsapp/messages/WABA_ID/messageSamples' \ --header 'Content-Type: application/json' \ --header "X-API-Key: ${YCLOUD_API_KEY}" \ --data '{ "type": "text", "text": { "body": "Your order A123456 has shipped. Your estimated delivery date is September 15." } }' ``` Exemplo de resposta: ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "success": true, "category": "UTILITY" } ``` Verifique `category` antes de usar o conteúdo em uma solicitação de Direct Send de Utilidade. Se a Meta detectar `MARKETING` ou `AUTHENTICATION`, revise o conteúdo ou use o fluxo de mensagens apropriado. Para uma amostra com botão, envie os campos `type` e `interactive` a partir de um exemplo de envio acima; omita os campos de destinatário e de envio. ### Diferenciar um modelo pausado de uma restrição de conta Um modelo pode ser pausado devido à baixa qualidade. Mensagens que correspondem a ele, ou que são muito semelhantes, podem falhar com o erro da Meta `132015`. Encontre o modelo afetado na YCloud, inspecione seu conteúdo e status e resolva a causa antes de retomar essa notificação. O uso indevido repetido de categorias pode restringir o Direct Send para toda a WABA: | Etapa | Efeito | | - | - | | Aviso | A Meta identifica o uso indevido para que você possa corrigi-lo ou solicitar uma análise. | | Limite de taxa | A WABA pode enviar até um limite temporário. Envios adicionais de Utilidade podem retornar `131064`. | | Restrição de sete dias | O envio de mensagens via Direct Send é bloqueado por sete dias. | | Restrição de trinta dias | O uso indevido contínuo resulta em uma restrição prolongada. | | Revogação | O acesso ao Direct Send é permanentemente removido. | Acompanhe o aviso da conta para ver a restrição ativa e a expiração. Uma análise bem-sucedida de um modelo não cancela automaticamente uma restrição no nível da conta. ### Receber notificações da YCloud | Evento | Para que utilizá-lo | | - | - | | `whatsapp.message.updated` | Rastrear a entrega e inspecionar falhas de mensagens. | | `whatsapp.template.correct_category_detection` | Saber quando a Meta detecta uma categoria diferente para um modelo Direct Send de Utilidade. | | `whatsapp.business_account.updated` | Rastrear avisos, restrições e recuperação do Direct Send. | Inscreva-se em `whatsapp.template.correct_category_detection` por meio do seu [endpoint de webhook](/pt/api-reference/guides/api-fundamentals/configure-webhooks) se desejar notificações de detecção de categoria. Não é uma resposta para `messageSamples` e não é disparado para todas as mensagens. No `whatsappTemplate` do evento, compare `previousCategory` com `category`. Por exemplo, `previousCategory: "UTILITY"` e `category: "MARKETING"` indicam que a Meta identificou conteúdo de marketing em um modelo Direct Send de Utilidade. Revise o conteúdo antes de enviar mensagens semelhantes novamente. Use `whatsapp.message.updated` para rastrear a entrega separadamente. Campos relevantes de um evento de restrição de conta da YCloud: ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "id": "EVENT_ID", "type": "whatsapp.business_account.updated", "apiVersion": "v2", "whatsappBusinessAccount": { "id": "WABA_ID", "updateEvent": "ACCOUNT_RESTRICTION", "violationType": "DIRECT_SEND_UTILITY_CATEGORY_ABUSE_STRIKE_1", "restrictions": [ { "restrictionType": "RESTRICTED_DIRECT_SEND_UTILITY_TEMPLATES", "expiration": "2026-09-17T10:00:00.000Z" } ] } } ``` Use o ID da WABA para pausar o fluxo de trabalho afetado. Leia `violationType` para o motivo e `restrictions[].expiration` para a expiração, quando fornecido. ### Solicitar uma análise de uma decisão de categoria Se você acredita que o conteúdo foi sinalizado incorretamente, abra **Início do Suporte para Empresas da Meta → Conta do WhatsApp → Atualizações de modelos do Direct Send → Disponíveis para análise**. Selecione os modelos afetados e escolha **Solicitar análise**. Envie a solicitação em até 60 dias a partir da notificação. Cada modelo sinalizado pode ser analisado uma vez. Acompanhe o resultado como **Em análise**, **Revertido** ou **Inalterado**. Se a opção de análise não estiver disponível, entre em contato com a YCloud informando o WABA ID, o nome ou ID do modelo, o idioma e os detalhes da notificação. ## Perguntas frequentes sobre o Direct Send Não para conteúdo personalizado. Forneça a mensagem completa e deixe a Meta fazer a correspondência ou gerar um modelo. Para converter um modelo de Utilidade existente, forneça seu `template.name` e defina `useDirectSend: true`. O campo opcional `templateName` dá nome a um modelo de Direct Send de Utilidade; ele não seleciona um modelo existente. Os modelos oferecem suporte a verificações de categoria e qualidade, relatórios de desempenho e solução de problemas. O Direct Send elimina a necessidade de criá-los manualmente, mas não o processamento baseado em modelos por trás da mensagem. Sim, para notificações qualificadas do Direct Send de Utilidade. Sua WABA precisa ter acesso, o cliente deve estar esperando a mensagem e o conteúdo deve atender aos requisitos de Utilidade. Mensagens de serviço comuns em formato livre ainda exigem uma janela de atendimento aberta. A geração e a sincronização do modelo são assíncronas e podem ser concluídas após o envio da mensagem. Depois de concluído, selecione a WABA correta e use o filtro **Gerado automaticamente** . A Meta exclui após 24 horas os modelos gerados que nunca foram utilizados para envio. Os modelos usados anteriormente podem ser arquivados após um período de inatividade. Você não precisa excluí-los manualmente. Não. A Meta avalia o conteúdo real. Remova termos promocionais de notificações de Utilidade e use o processo de análise se uma mensagem genuína de Utilidade for sinalizada incorretamente. As mensagens de utilidade seguem as mesmas regras de preços de mensagens de utilidade dos modelos de utilidade criados manualmente. Consulte [Preços do WhatsApp](/pt/documentation/whatsapp-business-platform/pricing-limits-and-quality/whatsapp-pricing). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.