[{"data":1,"prerenderedAt":594},["ShallowReactive",2],{"artigos-lista":3},[4,200],{"id":5,"title":6,"author":7,"body":8,"date":188,"description":189,"extension":190,"meta":191,"navigation":192,"path":193,"seo":194,"stem":195,"tags":196,"__hash__":199},"artigos\u002Fartigos\u002Fexemplo-primeiro-artigo.md","Como conectar seu número do WhatsApp à Datafy API","Equipe Datafy",{"type":9,"value":10,"toc":183},"minimark",[11,20,25,28,51,55,67,70,162,168,172,179],[12,13,14,15,19],"p",{},"Este é um artigo de exemplo para mostrar o layout e a estrutura de um post. Pode apagar o arquivo ",[16,17,18],"code",{},"content\u002Fartigos\u002Fexemplo-primeiro-artigo.md"," quando for publicar os artigos de verdade.",[21,22,24],"h2",{"id":23},"o-que-você-precisa","O que você precisa",[12,26,27],{},"Antes de começar, tenha em mãos:",[29,30,31,40],"ul",{},[32,33,34,35,39],"li",{},"Um número de telefone que ",[36,37,38],"strong",{},"não"," esteja ativo em outra conta da API oficial.",[32,41,42,43,50],{},"Uma conta na ",[44,45,49],"a",{"href":46,"rel":47},"https:\u002F\u002Fapp.datafyapi.com.br",[48],"nofollow","Datafy API",".",[21,52,54],{"id":53},"passos","Passos",[56,57,58,61,64],"ol",{},[32,59,60],{},"Crie o canal no painel.",[32,62,63],{},"Conecte o número pelo cadastro incorporado da Meta.",[32,65,66],{},"Copie o token do canal.",[12,68,69],{},"Com o token em mãos, o envio é uma requisição simples:",[71,72,77],"pre",{"className":73,"code":74,"language":75,"meta":76,"style":76},"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\": \"Olá do Guia Datafy!\" }\n  }'\n","bash","",[16,78,79,102,113,123,132,138,144,150,156],{"__ignoreMap":76},[80,81,84,88,92,96,99],"span",{"class":82,"line":83},"line",1,[80,85,87],{"class":86},"sScJk","curl",[80,89,91],{"class":90},"sj4cs"," -X",[80,93,95],{"class":94},"sZZnC"," POST",[80,97,98],{"class":94}," https:\u002F\u002Fcloud.datafyapi.com.br\u002Fv1\u002F{phone_number_id}\u002Fmessages",[80,100,101],{"class":90}," \\\n",[80,103,105,108,111],{"class":82,"line":104},2,[80,106,107],{"class":90},"  -H",[80,109,110],{"class":94}," \"Authorization: Bearer SEU_TOKEN\"",[80,112,101],{"class":90},[80,114,116,118,121],{"class":82,"line":115},3,[80,117,107],{"class":90},[80,119,120],{"class":94}," \"Content-Type: application\u002Fjson\"",[80,122,101],{"class":90},[80,124,126,129],{"class":82,"line":125},4,[80,127,128],{"class":90},"  -d",[80,130,131],{"class":94}," '{\n",[80,133,135],{"class":82,"line":134},5,[80,136,137],{"class":94},"    \"messaging_product\": \"whatsapp\",\n",[80,139,141],{"class":82,"line":140},6,[80,142,143],{"class":94},"    \"to\": \"5511999999999\",\n",[80,145,147],{"class":82,"line":146},7,[80,148,149],{"class":94},"    \"type\": \"text\",\n",[80,151,153],{"class":82,"line":152},8,[80,154,155],{"class":94},"    \"text\": { \"body\": \"Olá do Guia Datafy!\" }\n",[80,157,159],{"class":82,"line":158},9,[80,160,161],{"class":94},"  }'\n",[163,164,165],"blockquote",{},[12,166,167],{},"A API é 100% compatível com a Cloud API da Meta: o mesmo payload que funciona lá funciona aqui.",[21,169,171],{"id":170},"próximos-passos","Próximos passos",[12,173,174,175,178],{},"Depois do primeiro envio, vale configurar os ",[36,176,177],{},"webhooks"," para receber as respostas e os status de entrega. Esse será o tema de outro artigo.",[180,181,182],"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":76,"searchDepth":104,"depth":104,"links":184},[185,186,187],{"id":23,"depth":104,"text":24},{"id":53,"depth":104,"text":54},{"id":170,"depth":104,"text":171},"2026-11-19","Passo a passo para conectar um número e enviar a primeira mensagem pela API oficial do WhatsApp, sem a burocracia da Meta.","md",{},true,"\u002Fartigos\u002Fexemplo-primeiro-artigo",{"title":6,"description":189},"artigos\u002Fexemplo-primeiro-artigo",[197,198],"primeiros-passos","whatsapp","hpAsr2b8FKf3adffFaILLbFXhrMxpqvgi_kn02cy1n4",{"id":201,"title":202,"author":7,"body":203,"date":188,"description":585,"extension":190,"meta":586,"navigation":192,"path":587,"seo":588,"stem":589,"tags":590,"__hash__":593},"artigos\u002Fartigos\u002Fjanela-de-24-horas.md","O que é a janela de 24 horas do WhatsApp e quando usar template",{"type":9,"value":204,"toc":573},[205,219,222,226,233,285,291,295,298,315,318,378,382,398,401,405,412,491,494,512,515,519,522,537,541,546,552,556,559,563,571],[12,206,207,208,211,212,215,216,50],{},"A janela de 24 horas é o período em que sua empresa pode mandar ",[36,209,210],{},"mensagens livres"," (texto, imagem, áudio, documento) para um contato pela API oficial do WhatsApp. Ela abre quando o ",[36,213,214],{},"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 ",[36,217,218],{},"template aprovado pela Meta",[12,220,221],{},"Essa regra é da Meta e vale para qualquer provedor da API oficial, incluindo a Datafy API.",[21,223,225],{"id":224},"quando-a-janela-de-24-horas-abre","Quando a janela de 24 horas abre?",[12,227,228,229,232],{},"A janela abre (ou é renovada) toda vez que o contato envia uma mensagem para o seu número. O prazo conta a partir da ",[36,230,231],{},"última"," mensagem recebida do cliente, não da primeira.",[234,235,236,249],"table",{},[237,238,239],"thead",{},[240,241,242,246],"tr",{},[243,244,245],"th",{},"Situação",[243,247,248],{},"Janela",[250,251,252,261,269,277],"tbody",{},[240,253,254,258],{},[255,256,257],"td",{},"Cliente manda mensagem às 10h de segunda",[255,259,260],{},"Aberta até 10h de terça",[240,262,263,266],{},[255,264,265],{},"Cliente manda outra mensagem às 15h de segunda",[255,267,268],{},"Renovada até 15h de terça",[240,270,271,274],{},[255,272,273],{},"Sua empresa responde várias vezes",[255,275,276],{},"Não muda o prazo",[240,278,279,282],{},[255,280,281],{},"Cliente não responde mais",[255,283,284],{},"Fecha 24h após a última mensagem dele",[12,286,287,288,290],{},"Mensagens enviadas pela empresa ",[36,289,38],{}," renovam a janela. Só a resposta do cliente renova.",[21,292,294],{"id":293},"o-que-posso-enviar-dentro-da-janela","O que posso enviar dentro da janela?",[12,296,297],{},"Com a janela aberta, você pode enviar qualquer tipo de mensagem suportado pela API, sem precisar de aprovação prévia:",[29,299,300,303,306,309,312],{},[32,301,302],{},"texto livre;",[32,304,305],{},"imagem, vídeo, áudio e documento;",[32,307,308],{},"mensagens interativas (botões e listas);",[32,310,311],{},"localização e contatos;",[32,313,314],{},"templates (também são permitidos dentro da janela).",[12,316,317],{},"Exemplo de texto livre:",[71,319,321],{"className":73,"code":320,"language":75,"meta":76,"style":76},"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",[16,322,323,335,343,351,357,361,365,369,374],{"__ignoreMap":76},[80,324,325,327,329,331,333],{"class":82,"line":83},[80,326,87],{"class":86},[80,328,91],{"class":90},[80,330,95],{"class":94},[80,332,98],{"class":94},[80,334,101],{"class":90},[80,336,337,339,341],{"class":82,"line":104},[80,338,107],{"class":90},[80,340,110],{"class":94},[80,342,101],{"class":90},[80,344,345,347,349],{"class":82,"line":115},[80,346,107],{"class":90},[80,348,120],{"class":94},[80,350,101],{"class":90},[80,352,353,355],{"class":82,"line":125},[80,354,128],{"class":90},[80,356,131],{"class":94},[80,358,359],{"class":82,"line":134},[80,360,137],{"class":94},[80,362,363],{"class":82,"line":140},[80,364,143],{"class":94},[80,366,367],{"class":82,"line":146},[80,368,149],{"class":94},[80,370,371],{"class":82,"line":152},[80,372,373],{"class":94},"    \"text\": { \"body\": \"Seu pedido foi separado e sai para entrega hoje.\" }\n",[80,375,376],{"class":82,"line":158},[80,377,161],{"class":94},[21,379,381],{"id":380},"o-que-acontece-se-eu-mandar-mensagem-livre-fora-da-janela","O que acontece se eu mandar mensagem livre fora da janela?",[12,383,384,385,388,389,392,393,397],{},"A mensagem ",[36,386,387],{},"não é entregue",". A API aceita a requisição, mas o webhook de status devolve uma falha com o código de erro ",[16,390,391],{},"131047"," (",[394,395,396],"em",{},"Re-engagement message","), indicando que já se passaram mais de 24 horas desde a última resposta do cliente.",[12,399,400],{},"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.",[21,402,404],{"id":403},"como-falar-com-o-cliente-depois-de-24-horas","Como falar com o cliente depois de 24 horas?",[12,406,407,408,411],{},"Envie um ",[36,409,410],{},"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.",[71,413,415],{"className":73,"code":414,"language":75,"meta":76,"style":76},"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",[16,416,417,429,437,445,451,455,459,464,469,474,480,486],{"__ignoreMap":76},[80,418,419,421,423,425,427],{"class":82,"line":83},[80,420,87],{"class":86},[80,422,91],{"class":90},[80,424,95],{"class":94},[80,426,98],{"class":94},[80,428,101],{"class":90},[80,430,431,433,435],{"class":82,"line":104},[80,432,107],{"class":90},[80,434,110],{"class":94},[80,436,101],{"class":90},[80,438,439,441,443],{"class":82,"line":115},[80,440,107],{"class":90},[80,442,120],{"class":94},[80,444,101],{"class":90},[80,446,447,449],{"class":82,"line":125},[80,448,128],{"class":90},[80,450,131],{"class":94},[80,452,453],{"class":82,"line":134},[80,454,137],{"class":94},[80,456,457],{"class":82,"line":140},[80,458,143],{"class":94},[80,460,461],{"class":82,"line":146},[80,462,463],{"class":94},"    \"type\": \"template\",\n",[80,465,466],{"class":82,"line":152},[80,467,468],{"class":94},"    \"template\": {\n",[80,470,471],{"class":82,"line":158},[80,472,473],{"class":94},"      \"name\": \"atualizacao_pedido\",\n",[80,475,477],{"class":82,"line":476},10,[80,478,479],{"class":94},"      \"language\": { \"code\": \"pt_BR\" }\n",[80,481,483],{"class":82,"line":482},11,[80,484,485],{"class":94},"    }\n",[80,487,489],{"class":82,"line":488},12,[80,490,161],{"class":94},[12,492,493],{},"Os campos principais:",[29,495,496,502],{},[32,497,498,501],{},[16,499,500],{},"name",": o nome exato do template aprovado.",[32,503,504,507,508,511],{},[16,505,506],{},"language.code",": o idioma em que o template foi aprovado (por exemplo, ",[16,509,510],{},"pt_BR",").",[12,513,514],{},"Quando o cliente responde ao template, uma nova janela de 24 horas se abre e você volta a poder enviar mensagens livres.",[21,516,518],{"id":517},"como-saber-se-a-janela-de-um-contato-está-aberta","Como saber se a janela de um contato está aberta?",[12,520,521],{},"A API não tem um campo que diga \"janela aberta\" ou \"fechada\". O controle fica do seu lado:",[56,523,524,531,534],{},[32,525,526,527,530],{},"Guarde a data e hora da ",[36,528,529],{},"última mensagem recebida"," de cada contato (ela chega no webhook de mensagens).",[32,532,533],{},"Antes de enviar, compare com a hora atual.",[32,535,536],{},"Se passou de 24 horas, use um template. Se não passou, pode mandar mensagem livre.",[21,538,540],{"id":539},"perguntas-frequentes","Perguntas frequentes",[542,543,545],"h3",{"id":544},"enviar-um-template-abre-a-janela","Enviar um template abre a janela?",[12,547,548,549,551],{},"Não. A janela só abre quando o ",[36,550,214],{}," envia uma mensagem. O template serve justamente para iniciar o contato quando ela está fechada.",[542,553,555],{"id":554},"preciso-de-template-para-responder-um-cliente-que-acabou-de-me-escrever","Preciso de template para responder um cliente que acabou de me escrever?",[12,557,558],{},"Não. Se ele escreveu há menos de 24 horas, a janela está aberta e você pode responder com mensagem livre.",[542,560,562],{"id":561},"onde-vejo-a-lista-completa-de-tipos-de-mensagem-e-erros","Onde vejo a lista completa de tipos de mensagem e erros?",[12,564,565,566,50],{},"Na ",[44,567,570],{"href":568,"rel":569},"https:\u002F\u002Fdevelopers.datafyapi.com.br",[48],"documentação da Datafy API",[180,572,182],{},{"title":76,"searchDepth":104,"depth":104,"links":574},[575,576,577,578,579,580],{"id":224,"depth":104,"text":225},{"id":293,"depth":104,"text":294},{"id":380,"depth":104,"text":381},{"id":403,"depth":104,"text":404},{"id":517,"depth":104,"text":518},{"id":539,"depth":104,"text":540,"children":581},[582,583,584],{"id":544,"depth":115,"text":545},{"id":554,"depth":115,"text":555},{"id":561,"depth":115,"text":562},"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.",{},"\u002Fartigos\u002Fjanela-de-24-horas",{"title":202,"description":585},"artigos\u002Fjanela-de-24-horas",[591,198,592],"templates","regras-da-meta","ff1f5_aICc0_kbFTybB-DXpws5BnBlzkBlal_N_2IkM",1795130677489]