[{"data":1,"prerenderedAt":448},["ShallowReactive",2],{"artigo-\u002Fartigos\u002Fjanela-de-24-horas":3},{"id":4,"title":5,"author":6,"body":7,"date":435,"description":436,"extension":437,"meta":438,"navigation":439,"path":440,"seo":441,"stem":442,"tags":443,"__hash__":447},"artigos\u002Fartigos\u002Fjanela-de-24-horas.md","O que é a janela de 24 horas do WhatsApp e quando usar template","Equipe Datafy",{"type":8,"value":9,"toc":423},"minimark",[10,27,30,35,42,94,101,105,108,127,130,223,227,243,246,250,257,336,339,357,360,364,367,383,387,392,398,402,405,409,419],[11,12,13,14,18,19,22,23,26],"p",{},"A janela de 24 horas é o período em que sua empresa pode mandar ",[15,16,17],"strong",{},"mensagens livres"," (texto, imagem, áudio, documento) para um contato pela API oficial do WhatsApp. Ela abre quando o ",[15,20,21],{},"cliente"," envia uma mensagem para o seu número e fica aberta por 24 horas a partir da última mensagem dele. Fora da janela, só é possível iniciar a conversa com um ",[15,24,25],{},"template aprovado pela Meta",".",[11,28,29],{},"Essa regra é da Meta e vale para qualquer provedor da API oficial, incluindo a Datafy API.",[31,32,34],"h2",{"id":33},"quando-a-janela-de-24-horas-abre","Quando a janela de 24 horas abre?",[11,36,37,38,41],{},"A janela abre (ou é renovada) toda vez que o contato envia uma mensagem para o seu número. O prazo conta a partir da ",[15,39,40],{},"última"," mensagem recebida do cliente, não da primeira.",[43,44,45,58],"table",{},[46,47,48],"thead",{},[49,50,51,55],"tr",{},[52,53,54],"th",{},"Situação",[52,56,57],{},"Janela",[59,60,61,70,78,86],"tbody",{},[49,62,63,67],{},[64,65,66],"td",{},"Cliente manda mensagem às 10h de segunda",[64,68,69],{},"Aberta até 10h de terça",[49,71,72,75],{},[64,73,74],{},"Cliente manda outra mensagem às 15h de segunda",[64,76,77],{},"Renovada até 15h de terça",[49,79,80,83],{},[64,81,82],{},"Sua empresa responde várias vezes",[64,84,85],{},"Não muda o prazo",[49,87,88,91],{},[64,89,90],{},"Cliente não responde mais",[64,92,93],{},"Fecha 24h após a última mensagem dele",[11,95,96,97,100],{},"Mensagens enviadas pela empresa ",[15,98,99],{},"não"," renovam a janela. Só a resposta do cliente renova.",[31,102,104],{"id":103},"o-que-posso-enviar-dentro-da-janela","O que posso enviar dentro da janela?",[11,106,107],{},"Com a janela aberta, você pode enviar qualquer tipo de mensagem suportado pela API, sem precisar de aprovação prévia:",[109,110,111,115,118,121,124],"ul",{},[112,113,114],"li",{},"texto livre;",[112,116,117],{},"imagem, vídeo, áudio e documento;",[112,119,120],{},"mensagens interativas (botões e listas);",[112,122,123],{},"localização e contatos;",[112,125,126],{},"templates (também são permitidos dentro da janela).",[11,128,129],{},"Exemplo de texto livre:",[131,132,137],"pre",{"className":133,"code":134,"language":135,"meta":136,"style":136},"language-bash shiki shiki-themes github-light github-dark","curl -X POST https:\u002F\u002Fcloud.datafyapi.com.br\u002Fv1\u002F{phone_number_id}\u002Fmessages \\\n  -H \"Authorization: Bearer SEU_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"messaging_product\": \"whatsapp\",\n    \"to\": \"5511999999999\",\n    \"type\": \"text\",\n    \"text\": { \"body\": \"Seu pedido foi separado e sai para entrega hoje.\" }\n  }'\n","bash","",[138,139,140,163,174,184,193,199,205,211,217],"code",{"__ignoreMap":136},[141,142,145,149,153,157,160],"span",{"class":143,"line":144},"line",1,[141,146,148],{"class":147},"sScJk","curl",[141,150,152],{"class":151},"sj4cs"," -X",[141,154,156],{"class":155},"sZZnC"," POST",[141,158,159],{"class":155}," https:\u002F\u002Fcloud.datafyapi.com.br\u002Fv1\u002F{phone_number_id}\u002Fmessages",[141,161,162],{"class":151}," \\\n",[141,164,166,169,172],{"class":143,"line":165},2,[141,167,168],{"class":151},"  -H",[141,170,171],{"class":155}," \"Authorization: Bearer SEU_TOKEN\"",[141,173,162],{"class":151},[141,175,177,179,182],{"class":143,"line":176},3,[141,178,168],{"class":151},[141,180,181],{"class":155}," \"Content-Type: application\u002Fjson\"",[141,183,162],{"class":151},[141,185,187,190],{"class":143,"line":186},4,[141,188,189],{"class":151},"  -d",[141,191,192],{"class":155}," '{\n",[141,194,196],{"class":143,"line":195},5,[141,197,198],{"class":155},"    \"messaging_product\": \"whatsapp\",\n",[141,200,202],{"class":143,"line":201},6,[141,203,204],{"class":155},"    \"to\": \"5511999999999\",\n",[141,206,208],{"class":143,"line":207},7,[141,209,210],{"class":155},"    \"type\": \"text\",\n",[141,212,214],{"class":143,"line":213},8,[141,215,216],{"class":155},"    \"text\": { \"body\": \"Seu pedido foi separado e sai para entrega hoje.\" }\n",[141,218,220],{"class":143,"line":219},9,[141,221,222],{"class":155},"  }'\n",[31,224,226],{"id":225},"o-que-acontece-se-eu-mandar-mensagem-livre-fora-da-janela","O que acontece se eu mandar mensagem livre fora da janela?",[11,228,229,230,233,234,237,238,242],{},"A mensagem ",[15,231,232],{},"não é entregue",". A API aceita a requisição, mas o webhook de status devolve uma falha com o código de erro ",[138,235,236],{},"131047"," (",[239,240,241],"em",{},"Re-engagement message","), indicando que já se passaram mais de 24 horas desde a última resposta do cliente.",[11,244,245],{},"Se você vê esse erro com frequência, o seu sistema está tentando falar com contatos cuja janela já fechou. A solução é trocar a mensagem livre por um template.",[31,247,249],{"id":248},"como-falar-com-o-cliente-depois-de-24-horas","Como falar com o cliente depois de 24 horas?",[11,251,252,253,256],{},"Envie um ",[15,254,255],{},"template de mensagem",": um modelo de texto cadastrado e aprovado pela Meta antes do uso. Templates podem ter variáveis (nome, número do pedido, data) e botões.",[131,258,260],{"className":133,"code":259,"language":135,"meta":136,"style":136},"curl -X POST https:\u002F\u002Fcloud.datafyapi.com.br\u002Fv1\u002F{phone_number_id}\u002Fmessages \\\n  -H \"Authorization: Bearer SEU_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"messaging_product\": \"whatsapp\",\n    \"to\": \"5511999999999\",\n    \"type\": \"template\",\n    \"template\": {\n      \"name\": \"atualizacao_pedido\",\n      \"language\": { \"code\": \"pt_BR\" }\n    }\n  }'\n",[138,261,262,274,282,290,296,300,304,309,314,319,325,331],{"__ignoreMap":136},[141,263,264,266,268,270,272],{"class":143,"line":144},[141,265,148],{"class":147},[141,267,152],{"class":151},[141,269,156],{"class":155},[141,271,159],{"class":155},[141,273,162],{"class":151},[141,275,276,278,280],{"class":143,"line":165},[141,277,168],{"class":151},[141,279,171],{"class":155},[141,281,162],{"class":151},[141,283,284,286,288],{"class":143,"line":176},[141,285,168],{"class":151},[141,287,181],{"class":155},[141,289,162],{"class":151},[141,291,292,294],{"class":143,"line":186},[141,293,189],{"class":151},[141,295,192],{"class":155},[141,297,298],{"class":143,"line":195},[141,299,198],{"class":155},[141,301,302],{"class":143,"line":201},[141,303,204],{"class":155},[141,305,306],{"class":143,"line":207},[141,307,308],{"class":155},"    \"type\": \"template\",\n",[141,310,311],{"class":143,"line":213},[141,312,313],{"class":155},"    \"template\": {\n",[141,315,316],{"class":143,"line":219},[141,317,318],{"class":155},"      \"name\": \"atualizacao_pedido\",\n",[141,320,322],{"class":143,"line":321},10,[141,323,324],{"class":155},"      \"language\": { \"code\": \"pt_BR\" }\n",[141,326,328],{"class":143,"line":327},11,[141,329,330],{"class":155},"    }\n",[141,332,334],{"class":143,"line":333},12,[141,335,222],{"class":155},[11,337,338],{},"Os campos principais:",[109,340,341,347],{},[112,342,343,346],{},[138,344,345],{},"name",": o nome exato do template aprovado.",[112,348,349,352,353,356],{},[138,350,351],{},"language.code",": o idioma em que o template foi aprovado (por exemplo, ",[138,354,355],{},"pt_BR",").",[11,358,359],{},"Quando o cliente responde ao template, uma nova janela de 24 horas se abre e você volta a poder enviar mensagens livres.",[31,361,363],{"id":362},"como-saber-se-a-janela-de-um-contato-está-aberta","Como saber se a janela de um contato está aberta?",[11,365,366],{},"A API não tem um campo que diga \"janela aberta\" ou \"fechada\". O controle fica do seu lado:",[368,369,370,377,380],"ol",{},[112,371,372,373,376],{},"Guarde a data e hora da ",[15,374,375],{},"última mensagem recebida"," de cada contato (ela chega no webhook de mensagens).",[112,378,379],{},"Antes de enviar, compare com a hora atual.",[112,381,382],{},"Se passou de 24 horas, use um template. Se não passou, pode mandar mensagem livre.",[31,384,386],{"id":385},"perguntas-frequentes","Perguntas frequentes",[388,389,391],"h3",{"id":390},"enviar-um-template-abre-a-janela","Enviar um template abre a janela?",[11,393,394,395,397],{},"Não. A janela só abre quando o ",[15,396,21],{}," envia uma mensagem. O template serve justamente para iniciar o contato quando ela está fechada.",[388,399,401],{"id":400},"preciso-de-template-para-responder-um-cliente-que-acabou-de-me-escrever","Preciso de template para responder um cliente que acabou de me escrever?",[11,403,404],{},"Não. Se ele escreveu há menos de 24 horas, a janela está aberta e você pode responder com mensagem livre.",[388,406,408],{"id":407},"onde-vejo-a-lista-completa-de-tipos-de-mensagem-e-erros","Onde vejo a lista completa de tipos de mensagem e erros?",[11,410,411,412,26],{},"Na ",[413,414,418],"a",{"href":415,"rel":416},"https:\u002F\u002Fdevelopers.datafyapi.com.br",[417],"nofollow","documentação da Datafy API",[420,421,422],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":136,"searchDepth":165,"depth":165,"links":424},[425,426,427,428,429,430],{"id":33,"depth":165,"text":34},{"id":103,"depth":165,"text":104},{"id":225,"depth":165,"text":226},{"id":248,"depth":165,"text":249},{"id":362,"depth":165,"text":363},{"id":385,"depth":165,"text":386,"children":431},[432,433,434],{"id":390,"depth":176,"text":391},{"id":400,"depth":176,"text":401},{"id":407,"depth":176,"text":408},"2026-11-19","Entenda a janela de atendimento de 24 horas da API oficial do WhatsApp, o que dá para enviar dentro e fora dela e como evitar o erro 131047.","md",{},true,"\u002Fartigos\u002Fjanela-de-24-horas",{"title":5,"description":436},"artigos\u002Fjanela-de-24-horas",[444,445,446],"templates","whatsapp","regras-da-meta","ff1f5_aICc0_kbFTybB-DXpws5BnBlzkBlal_N_2IkM",1795130677722]