[{"data":1,"prerenderedAt":669},["ShallowReactive",2],{"docs-pages-meta":3,"i-lucide:menu":142,"i-fa6-solid:book":147,"i-fa6-solid:signs-post":151,"i-lucide:search":153,"i-lucide:languages":155,"i-lucide:chevron-down":157,"i-lucide:moon":159,"i-lucide:sparkles":161,"i-fa6-solid:key":163,"i-fa6-solid:list-check":165,"i-lucide:webhook":167,"i-fa6-solid:tower-broadcast":169,"i-lucide:compass":172,"i-fa6-brands:whatsapp":174,"i-fa6-solid:layer-group":176,"i-lucide:life-buoy":178,"i-fa6-solid:gear":180,"i-lucide:bot":182,"i-lucide:chart-column":184,"i-fa6-solid:plug":186,"i-lucide:arrow-up-right":189,"docs-page:\u002Fpt-BR\u002Fapi-reference\u002Fv3":191,"i-fa6-solid:circle-info":659,"i-lucide:copy":661,"i-fa6-solid:bolt":663,"i-lucide:arrow-right":665,"i-lucide:chevron-right":667},[4,9,14,19,22,27,30,35,38,42,47,52,56,61,66,71,76,79,83,87,90,93,97,100,104,107,111,115,119,123,127,131,135,139],{"path":5,"title":6,"description":7,"icon":8},"\u002Fen\u002Fapi-reference\u002Fv2\u002Fauthentication","Authentication","Learn how to generate and manage your access credentials to use the API securely.","key",{"path":10,"title":11,"description":12,"icon":13},"\u002Fen\u002Fapi-reference\u002Fv2","Introduction","The v2 API: connections, chats, messages and templates.","sparkles",{"path":15,"title":16,"description":17,"icon":18},"\u002Fen\u002Fapi-reference\u002Fv2\u002Fwebhooks","Webhooks","In this section, you’ll learn how to integrate and use webhooks and messaging events to connect your application to your projects.","webhook",{"path":20,"title":6,"description":21,"icon":8},"\u002Fen\u002Fapi-reference\u002Fv3\u002Fauthentication","How a v3 request proves who it is, and which workspace it acts on.",{"path":23,"title":24,"description":25,"icon":26},"\u002Fen\u002Fapi-reference\u002Fv3\u002Fconventions","Conventions","Pagination, errors, ids and dates — the rules every v3 endpoint follows.","list-check",{"path":28,"title":11,"description":29,"icon":13},"\u002Fen\u002Fapi-reference\u002Fv3","The v3 API: workspaces, connections, campaigns and the helpdesk.",{"path":31,"title":32,"description":33,"icon":34},"\u002Fen\u002Fapi-reference\u002Fv3\u002Frealtime","Realtime","The websocket behind the shared inbox: live conversations, typing and presence.","tower-broadcast",{"path":36,"title":16,"description":37,"icon":18},"\u002Fen\u002Fapi-reference\u002Fv3\u002Fwebhooks","Receive WhatsApp and helpdesk events on your own server, and prove they came from us.",{"path":39,"title":40,"description":41,"icon":8},"\u002Fen\u002Fapikeys","API Keys","Understand what API Keys are and why they are required to use Pingo Notify securely.",{"path":43,"title":44,"description":45,"icon":46},"\u002Fen\u002Fconnections","Connections","Connections represent WhatsApp sessions linked to Pingo Notify, used for sending, receiving, and integrations.","qrcode",{"path":48,"title":49,"description":50,"icon":51},"\u002Fen\u002Fhooks-and-development","Hooks and Development","Extend the Pingo Notify WordPress plugin with custom triggers, groups, and hooks.","code",{"path":53,"title":54,"description":55,"icon":13},"\u002Fen","Introduction to Pingo Notify","Connect WhatsApp to your systems, automate workflows, and send messages.",{"path":57,"title":58,"description":59,"icon":60},"\u002Fen\u002Fintegrations","Integrations","Integrations represent external applications linked to Pingo Notify, authorized to access resources such as connections, plans, and messaging.","cube",{"path":62,"title":63,"description":64,"icon":65},"\u002Fen\u002Fofficial-whatsapp-api","Official WhatsApp API","Step-by-step guide to request access to the Official WhatsApp Business API and connect it to Pingo Notify.","badge-check",{"path":67,"title":68,"description":69,"icon":70},"\u002Fen\u002Fplugin-wordpress","Get started","WordPress plugin that connects events from your site to Pingo Notify for automatic notification delivery.","wordpress",{"path":72,"title":73,"description":74,"icon":75},"\u002Fen\u002Ftemplate-plugins","Templates Guide","Learn how to create custom dynamic messages.","square-envelope",{"path":77,"title":16,"description":78,"icon":18},"\u002Fen\u002Fwebhooks","Receive WhatsApp events in real time by linking webhooks to one or more connections in Pingo Notify.",{"path":80,"title":81,"description":82,"icon":8},"\u002Fpt-BR\u002Fapi-reference\u002Fv2\u002Fauthentication","Autenticação","Veja como gerar e gerenciar suas credenciais de acesso para utilizar a API com segurança.",{"path":84,"title":85,"description":86,"icon":13},"\u002Fpt-BR\u002Fapi-reference\u002Fv2","Introdução","A API v2: conexões, conversas, mensagens e templates.",{"path":88,"title":16,"description":89,"icon":18},"\u002Fpt-BR\u002Fapi-reference\u002Fv2\u002Fwebhooks","Nesta seção, você aprende como integrar e utilizar webhooks e eventos de mensageria para conectar a aplicação aos seus projetos.",{"path":91,"title":81,"description":92,"icon":8},"\u002Fpt-BR\u002Fapi-reference\u002Fv3\u002Fauthentication","Como uma requisição v3 prova quem é, e em qual workspace ela atua.",{"path":94,"title":95,"description":96,"icon":26},"\u002Fpt-BR\u002Fapi-reference\u002Fv3\u002Fconventions","Convenções","Paginação, erros, ids e datas — as regras que todo endpoint da v3 segue.",{"path":98,"title":85,"description":99,"icon":13},"\u002Fpt-BR\u002Fapi-reference\u002Fv3","A API v3: workspaces, conexões, campanhas e o helpdesk.",{"path":101,"title":102,"description":103,"icon":34},"\u002Fpt-BR\u002Fapi-reference\u002Fv3\u002Frealtime","Tempo real","O websocket por trás da caixa compartilhada: conversas ao vivo, digitação e presença.",{"path":105,"title":16,"description":106,"icon":18},"\u002Fpt-BR\u002Fapi-reference\u002Fv3\u002Fwebhooks","Receba eventos do WhatsApp e do helpdesk no seu servidor, e prove que vieram de nós.",{"path":108,"title":109,"description":110,"icon":8},"\u002Fpt-BR\u002Fapikeys","Chaves de API","Entenda o que são Chaves de API e por que elas são necessárias para usar o Pingo Notify com segurança.",{"path":112,"title":113,"description":114,"icon":46},"\u002Fpt-BR\u002Fconnections","Conexões","Conexões representam sessões do WhatsApp vinculadas ao Pingo Notify, usadas para envio, recebimento e integrações.",{"path":116,"title":117,"description":118,"icon":51},"\u002Fpt-BR\u002Fhooks-and-development","Hooks e Desenvolvimento","Estenda o plugin WordPress do Pingo Notify com gatilhos, grupos e hooks personalizados.",{"path":120,"title":121,"description":122,"icon":13},"\u002Fpt-BR","Introdução ao Pingo Notify","Conecte o WhatsApp aos seus sistemas, automatize fluxos e envie mensagens.",{"path":124,"title":125,"description":126,"icon":60},"\u002Fpt-BR\u002Fintegrations","Integrações","Integrações representam aplicações externas vinculadas ao Pingo Notify, autorizadas a acessar recursos como conexões, planos e mensageria.",{"path":128,"title":129,"description":130,"icon":65},"\u002Fpt-BR\u002Fofficial-whatsapp-api","API Oficial do WhatsApp","Guia passo a passo para solicitar acesso à API Oficial do WhatsApp Business e conectá-la ao Pingo Notify.",{"path":132,"title":133,"description":134,"icon":70},"\u002Fpt-BR\u002Fplugin-wordpress","Primeiros passos","Plugin WordPress que conecta eventos do seu site ao Pingo Notify para envio automático de notificações.",{"path":136,"title":137,"description":138,"icon":75},"\u002Fpt-BR\u002Ftemplate-plugins","Guia de Templates","Aprenda a criar mensagens dinâmicas personalizadas.",{"path":140,"title":16,"description":141,"icon":18},"\u002Fpt-BR\u002Fwebhooks","Receba eventos do WhatsApp em tempo real vinculando webhooks a uma ou mais conexões no Pingo Notify.",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":146},0,24,false,"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M4 5h16M4 12h16M4 19h16\"\u002F>",{"left":143,"top":143,"width":148,"height":149,"rotate":143,"vFlip":145,"hFlip":145,"body":150},448,512,"\u003Cpath fill=\"currentColor\" d=\"M96 0C43 0 0 43 0 96v320c0 53 43 96 96 96h320c17.7 0 32-14.3 32-32s-14.3-32-32-32v-64c17.7 0 32-14.3 32-32V32c0-17.7-14.3-32-32-32zm0 384h256v64H96c-17.7 0-32-14.3-32-32s14.3-32 32-32m32-240c0-8.8 7.2-16 16-16h192c8.8 0 16 7.2 16 16s-7.2 16-16 16H144c-8.8 0-16-7.2-16-16m16 48h192c8.8 0 16 7.2 16 16s-7.2 16-16 16H144c-8.8 0-16-7.2-16-16s7.2-16 16-16\"\u002F>",{"left":143,"top":143,"width":149,"height":149,"rotate":143,"vFlip":145,"hFlip":145,"body":152},"\u003Cpath fill=\"currentColor\" d=\"M224 32H64c-17.7 0-32 14.3-32 32v64c0 17.7 14.3 32 32 32h377.4c4.2 0 8.3-1.7 11.3-4.7l48-48c6.2-6.2 6.2-16.4 0-22.6l-48-48c-3-3-7.1-4.7-11.3-4.7H288c0-17.7-14.3-32-32-32s-32 14.3-32 32m256 224c0-17.7-14.3-32-32-32H288v-32h-64v32H70.6c-4.2 0-8.3 1.7-11.3 4.7l-48 48c-6.2 6.2-6.2 16.4 0 22.6l48 48c3 3 7.1 4.7 11.3 4.7H448c17.7 0 32-14.3 32-32zM288 480v-96h-64v96c0 17.7 14.3 32 32 32s32-14.3 32-32\"\u002F>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":154},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"m21 21l-4.34-4.34\"\u002F>\u003Ccircle cx=\"11\" cy=\"11\" r=\"8\"\u002F>\u003C\u002Fg>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":156},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m5 8l6 6m-7 0l6-6l2-3M2 5h12M7 2h1m14 20l-5-10l-5 10m2-4h6\"\u002F>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":158},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m6 9l6 6l6-6\"\u002F>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":160},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401\"\u002F>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":162},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594zM20 2v4m2-2h-4\"\u002F>\u003Ccircle cx=\"4\" cy=\"20\" r=\"2\"\u002F>\u003C\u002Fg>",{"left":143,"top":143,"width":149,"height":149,"rotate":143,"vFlip":145,"hFlip":145,"body":164},"\u003Cpath fill=\"currentColor\" d=\"M336 352c97.2 0 176-78.8 176-176S433.2 0 336 0S160 78.8 160 176c0 18.7 2.9 36.8 8.3 53.7L7 391c-4.5 4.5-7 10.6-7 17v80c0 13.3 10.7 24 24 24h80c13.3 0 24-10.7 24-24v-40h40c13.3 0 24-10.7 24-24v-40h40c6.4 0 12.5-2.5 17-7l33.3-33.3c16.9 5.4 35 8.3 53.7 8.3m40-256a40 40 0 1 1 0 80a40 40 0 1 1 0-80\"\u002F>",{"left":143,"top":143,"width":149,"height":149,"rotate":143,"vFlip":145,"hFlip":145,"body":166},"\u003Cpath fill=\"currentColor\" d=\"M152.1 38.2c9.9 8.9 10.7 24 1.8 33.9l-72 80c-4.4 4.9-10.6 7.8-17.2 7.9s-12.9-2.4-17.6-7L7 113c-9.3-9.4-9.3-24.6 0-34s24.6-9.4 33.9 0L63 101.1l55.1-61.2c8.9-9.9 24-10.7 33.9-1.8zm0 160c9.9 8.9 10.7 24 1.8 33.9l-72 80c-4.4 4.9-10.6 7.8-17.2 7.9s-12.9-2.4-17.6-7L7 273c-9.4-9.4-9.4-24.6 0-33.9s24.6-9.4 33.9 0L63 261.2l55.1-61.2c8.9-9.9 24-10.7 33.9-1.8zM224 96c0-17.7 14.3-32 32-32h224c17.7 0 32 14.3 32 32s-14.3 32-32 32H256c-17.7 0-32-14.3-32-32m0 160c0-17.7 14.3-32 32-32h224c17.7 0 32 14.3 32 32s-14.3 32-32 32H256c-17.7 0-32-14.3-32-32m-64 160c0-17.7 14.3-32 32-32h288c17.7 0 32 14.3 32 32s-14.3 32-32 32H192c-17.7 0-32-14.3-32-32M48 368a48 48 0 1 1 0 96a48 48 0 1 1 0-96\"\u002F>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":168},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M18 16.98h-5.99c-1.1 0-1.95.94-2.48 1.9A4 4 0 0 1 2 17c.01-.7.2-1.4.57-2\"\u002F>\u003Cpath d=\"m6 17l3.13-5.78c.53-.97.1-2.18-.5-3.1a4 4 0 1 1 6.89-4.06\"\u002F>\u003Cpath d=\"m12 6l3.13 5.73C15.66 12.7 16.9 13 18 13a4 4 0 0 1 0 8\"\u002F>\u003C\u002Fg>",{"left":143,"top":143,"width":170,"height":149,"rotate":143,"vFlip":145,"hFlip":145,"body":171},576,"\u003Cpath fill=\"currentColor\" d=\"M80.3 44C69.8 69.9 64 98.2 64 128s5.8 58.1 16.3 84c6.6 16.4-1.3 35-17.7 41.7s-35-1.3-41.7-17.7C7.4 202.6 0 166.1 0 128S7.4 53.4 20.9 20C27.6 3.6 46.2-4.3 62.6 2.3S86.9 27.6 80.3 44m474.8-24C568.6 53.4 576 89.9 576 128s-7.4 74.6-20.9 108c-6.6 16.4-25.3 24.3-41.7 17.7s-24.3-25.3-17.7-41.7c10.5-25.9 16.3-54.2 16.3-84s-5.8-58.1-16.3-84c-6.6-16.4 1.3-35 17.7-41.7s35 1.3 41.7 17.7M352 128c0 23.7-12.9 44.4-32 55.4V480c0 17.7-14.3 32-32 32s-32-14.3-32-32V183.4c-19.1-11.1-32-31.7-32-55.4c0-35.3 28.7-64 64-64s64 28.7 64 64M170.6 76.8C163.8 92.4 160 109.7 160 128s3.8 35.6 10.6 51.2c7.1 16.2-.3 35.1-16.5 42.1S119 221 112 204.8c-10.3-23.6-16-49.6-16-76.8s5.7-53.2 16-76.8c7.1-16.2 25.9-23.6 42.1-16.5s23.6 25.9 16.5 42.1M464 51.2c10.3 23.6 16 49.6 16 76.8s-5.7 53.2-16 76.8c-7.1 16.2-25.9 23.6-42.1 16.5s-23.6-25.9-16.5-42.1c6.8-15.6 10.6-32.9 10.6-51.2s-3.8-35.6-10.6-51.2c-7.1-16.2.3-35.1 16.5-42.1S457 35 464 51.2\"\u002F>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":173},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"m16.24 7.76l-1.804 5.411a2 2 0 0 1-1.265 1.265L7.76 16.24l1.804-5.411a2 2 0 0 1 1.265-1.265z\"\u002F>\u003C\u002Fg>",{"left":143,"top":143,"width":148,"height":149,"rotate":143,"vFlip":145,"hFlip":145,"body":175},"\u003Cpath fill=\"currentColor\" d=\"M380.9 97.1C339 55.1 283.2 32 223.9 32c-122.4 0-222 99.6-222 222c0 39.1 10.2 77.3 29.6 111L0 480l117.7-30.9c32.4 17.7 68.9 27 106.1 27h.1c122.3 0 224.1-99.6 224.1-222c0-59.3-25.2-115-67.1-157m-157 341.6c-33.2 0-65.7-8.9-94-25.7l-6.7-4l-69.8 18.3L72 359.2l-4.4-7c-18.5-29.4-28.2-63.3-28.2-98.2c0-101.7 82.8-184.5 184.6-184.5c49.3 0 95.6 19.2 130.4 54.1s56.2 81.2 56.1 130.5c0 101.8-84.9 184.6-186.6 184.6m101.2-138.2c-5.5-2.8-32.8-16.2-37.9-18c-5.1-1.9-8.8-2.8-12.5 2.8s-14.3 18-17.6 21.8c-3.2 3.7-6.5 4.2-12 1.4c-32.6-16.3-54-29.1-75.5-66c-5.7-9.8 5.7-9.1 16.3-30.3c1.8-3.7.9-6.9-.5-9.7s-12.5-30.1-17.1-41.2c-4.5-10.8-9.1-9.3-12.5-9.5c-3.2-.2-6.9-.2-10.6-.2s-9.7 1.4-14.8 6.9c-5.1 5.6-19.4 19-19.4 46.3s19.9 53.7 22.6 57.4c2.8 3.7 39.1 59.7 94.8 83.8c35.2 15.2 49 16.5 66.6 13.9c10.7-1.6 32.8-13.4 37.4-26.4s4.6-24.1 3.2-26.4c-1.3-2.5-5-3.9-10.5-6.6\"\u002F>",{"left":143,"top":143,"width":170,"height":149,"rotate":143,"vFlip":145,"hFlip":145,"body":177},"\u003Cpath fill=\"currentColor\" d=\"M264.5 5.2c14.9-6.9 32.1-6.9 47 0l218.6 101c8.5 3.9 13.9 12.4 13.9 21.8s-5.4 17.9-13.9 21.8l-218.6 101c-14.9 6.9-32.1 6.9-47 0l-218.6-101c-8.5-4-13.9-12.5-13.9-21.8s5.4-17.9 13.9-21.8zm212.4 204.4l53.2 24.6c8.5 3.9 13.9 12.4 13.9 21.8s-5.4 17.9-13.9 21.8l-218.6 101c-14.9 6.9-32.1 6.9-47 0l-218.6-101c-8.5-4-13.9-12.5-13.9-21.8s5.4-17.9 13.9-21.8l53.2-24.6l152 70.2a88.1 88.1 0 0 0 73.8 0zm-152 198.2l152-70.2l53.2 24.6c8.5 3.9 13.9 12.4 13.9 21.8s-5.4 17.9-13.9 21.8l-218.6 101c-14.9 6.9-32.1 6.9-47 0l-218.6-101c-8.5-4-13.9-12.5-13.9-21.8s5.4-17.9 13.9-21.8l53.2-24.6l152 70.2a88.1 88.1 0 0 0 73.8 0\"\u002F>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":179},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"m4.93 4.93l4.24 4.24m5.66 0l4.24-4.24m-4.24 9.9l4.24 4.24m-9.9-4.24l-4.24 4.24\"\u002F>\u003Ccircle cx=\"12\" cy=\"12\" r=\"4\"\u002F>\u003C\u002Fg>",{"left":143,"top":143,"width":149,"height":149,"rotate":143,"vFlip":145,"hFlip":145,"body":181},"\u003Cpath fill=\"currentColor\" d=\"M495.9 166.6c3.2 8.7.5 18.4-6.4 24.6l-43.3 39.4c1.1 8.3 1.7 16.8 1.7 25.4s-.6 17.1-1.7 25.4l43.3 39.4c6.9 6.2 9.6 15.9 6.4 24.6c-4.4 11.9-9.7 23.3-15.8 34.3l-4.7 8.1c-6.6 11-14 21.4-22.1 31.2c-5.9 7.2-15.7 9.6-24.5 6.8l-55.7-17.7c-13.4 10.3-28.2 18.9-44 25.4l-12.5 57.1c-2 9.1-9 16.3-18.2 17.8c-13.8 2.3-28 3.5-42.5 3.5s-28.7-1.2-42.5-3.5c-9.2-1.5-16.2-8.7-18.2-17.8l-12.5-57.1c-15.8-6.5-30.6-15.1-44-25.4l-55.6 17.8c-8.8 2.8-18.6.3-24.5-6.8c-8.1-9.8-15.5-20.2-22.1-31.2l-4.7-8.1c-6.1-11-11.4-22.4-15.8-34.3c-3.2-8.7-.5-18.4 6.4-24.6l43.3-39.4c-1.1-8.4-1.7-16.9-1.7-25.5s.6-17.1 1.7-25.4l-43.3-39.4c-6.9-6.2-9.6-15.9-6.4-24.6c4.4-11.9 9.7-23.3 15.8-34.3l4.7-8.1c6.6-11 14-21.4 22.1-31.2c5.9-7.2 15.7-9.6 24.5-6.8l55.7 17.7c13.4-10.3 28.2-18.9 44-25.4l12.5-57.1c2-9.1 9-16.3 18.2-17.8C227.3 1.2 241.5 0 256 0s28.7 1.2 42.5 3.5c9.2 1.5 16.2 8.7 18.2 17.8l12.5 57.1c15.8 6.5 30.6 15.1 44 25.4l55.7-17.7c8.8-2.8 18.6-.3 24.5 6.8c8.1 9.8 15.5 20.2 22.1 31.2l4.7 8.1c6.1 11 11.4 22.4 15.8 34.3zM256 336a80 80 0 1 0 0-160a80 80 0 1 0 0 160\"\u002F>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":183},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M12 8V4H8\"\u002F>\u003Crect width=\"16\" height=\"12\" x=\"4\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M2 14h2m16 0h2m-7-1v2m-6-2v2\"\u002F>\u003C\u002Fg>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":185},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M3 3v16a2 2 0 0 0 2 2h16m-3-4V9m-5 8V5M8 17v-3\"\u002F>",{"left":143,"top":143,"width":187,"height":149,"rotate":143,"vFlip":145,"hFlip":145,"body":188},384,"\u003Cpath fill=\"currentColor\" d=\"M96 0C78.3 0 64 14.3 64 32v96h64V32c0-17.7-14.3-32-32-32m192 0c-17.7 0-32 14.3-32 32v96h64V32c0-17.7-14.3-32-32-32M32 160c-17.7 0-32 14.3-32 32s14.3 32 32 32v32c0 77.4 55 142 128 156.8V480c0 17.7 14.3 32 32 32s32-14.3 32-32v-67.2C297 398 352 333.4 352 256v-32c17.7 0 32-14.3 32-32s-14.3-32-32-32z\"\u002F>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":190},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M7 7h10v10M7 17L17 7\"\u002F>",{"id":192,"title":85,"body":193,"description":99,"extension":653,"hidden":145,"icon":13,"meta":654,"navigation":655,"path":98,"seo":656,"stem":657,"__hash__":658},"docs\u002Fpt-BR\u002Fapi-reference\u002Fv3\u002Findex.md",{"type":194,"value":195,"toc":646},"minimark",[196,200,206,216,221,228,231,253,268,274,278,281,314,411,414,475,479,495,498,527,534,538,548,555,603,610,613,617,642],[197,198,199],"p",{},"A API v3 é a mesma sobre a qual o painel do Pingo roda. Tudo o que você faz no produto, você faz aqui.",[197,201,202],{},[203,204,205],"strong",{},"URL base",[207,208,213],"pre",{"className":209,"code":211,"language":212},[210],"language-text","https:\u002F\u002Fapi.pingonotify.com\n","text",[51,214,211],{"__ignoreMap":215},"",[217,218,220],"h2",{"id":219},"o-que-mudou-da-v2","O que mudou da v2",[197,222,223,224,227],{},"A v2 era um conjunto de endpoints para os números de WhatsApp de um usuário. A v3 é organizada em torno de um ",[203,225,226],{},"workspace"," — um inquilino compartilhado que é dono das conexões, contatos, conversas e cobrança, e ao qual várias pessoas podem pertencer com papéis diferentes.",[197,229,230],{},"Essa reorganização traz três coisas que a v2 não tem:",[232,233,234,241,247],"ul",{},[235,236,237,240],"li",{},[203,238,239],{},"Uma caixa de entrada compartilhada."," Conversas, contatos, atribuição, SLAs, bots, relatórios — o helpdesk inteiro.",[235,242,243,246],{},[203,244,245],{},"Campanhas."," Uma mensagem para muitos destinatários, ritmada e medida.",[235,248,249,252],{},[203,250,251],{},"Equipes."," Membros, papéis e acesso por caixa de entrada.",[197,254,255,256,259,260,263,264,267],{},"Os endpoints de mensagem da v2 têm equivalentes diretos na v3, com uma mudança consistente: ",[203,257,258],{},"o destinatário nunca fica na URL",". Na v2 você enviava para ",[51,261,262],{},"\u002Fv2\u002Fconnections\u002F{id}\u002Fchats\u002F{remoteJid}\u002Fmessages","; na v3 o número viaja no corpo como ",[51,265,266],{},"to",", de modo que um número de telefone nunca acaba em uma linha de log ou no cache de um proxy.",[269,270,271],"note",{},[197,272,273],{},"A v2 não está descontinuada e continua funcionando. Você pode usar as duas — o mesmo token de API autentica ambas.",[217,275,277],{"id":276},"sua-primeira-requisição","Sua primeira requisição",[197,279,280],{},"Liste os workspaces que o seu token alcança:",[207,282,286],{"className":283,"code":284,"language":285,"meta":215,"style":215},"language-bash shiki shiki-themes github-light github-dark","curl https:\u002F\u002Fapi.pingonotify.com\u002Fv3\u002Faccounts \\\n  -H \"apikey: sk_live_...\"\n","bash",[51,287,288,305],{"__ignoreMap":215},[289,290,293,297,301],"span",{"class":291,"line":292},"line",1,[289,294,296],{"class":295},"sScJk","curl",[289,298,300],{"class":299},"sZZnC"," https:\u002F\u002Fapi.pingonotify.com\u002Fv3\u002Faccounts",[289,302,304],{"class":303},"sj4cs"," \\\n",[289,306,308,311],{"class":291,"line":307},2,[289,309,310],{"class":303},"  -H",[289,312,313],{"class":299}," \"apikey: sk_live_...\"\n",[207,315,319],{"className":316,"code":317,"language":318,"meta":215,"style":215},"language-json shiki shiki-themes github-light github-dark","[\n  {\n    \"id\": \"0195f3a0-1234-7890-abcd-ef0123456789\",\n    \"name\": \"Acme\",\n    \"isPersonal\": false,\n    \"roles\": [\"OWNER\"],\n    \"helpdeskEnabled\": true\n  }\n]\n","json",[51,320,321,327,332,347,360,373,388,399,405],{"__ignoreMap":215},[289,322,323],{"class":291,"line":292},[289,324,326],{"class":325},"sVt8B","[\n",[289,328,329],{"class":291,"line":307},[289,330,331],{"class":325},"  {\n",[289,333,335,338,341,344],{"class":291,"line":334},3,[289,336,337],{"class":303},"    \"id\"",[289,339,340],{"class":325},": ",[289,342,343],{"class":299},"\"0195f3a0-1234-7890-abcd-ef0123456789\"",[289,345,346],{"class":325},",\n",[289,348,350,353,355,358],{"class":291,"line":349},4,[289,351,352],{"class":303},"    \"name\"",[289,354,340],{"class":325},[289,356,357],{"class":299},"\"Acme\"",[289,359,346],{"class":325},[289,361,363,366,368,371],{"class":291,"line":362},5,[289,364,365],{"class":303},"    \"isPersonal\"",[289,367,340],{"class":325},[289,369,370],{"class":303},"false",[289,372,346],{"class":325},[289,374,376,379,382,385],{"class":291,"line":375},6,[289,377,378],{"class":303},"    \"roles\"",[289,380,381],{"class":325},": [",[289,383,384],{"class":299},"\"OWNER\"",[289,386,387],{"class":325},"],\n",[289,389,391,394,396],{"class":291,"line":390},7,[289,392,393],{"class":303},"    \"helpdeskEnabled\"",[289,395,340],{"class":325},[289,397,398],{"class":303},"true\n",[289,400,402],{"class":291,"line":401},8,[289,403,404],{"class":325},"  }\n",[289,406,408],{"class":291,"line":407},9,[289,409,410],{"class":325},"]\n",[197,412,413],{},"Depois envie uma mensagem por uma das suas conexões:",[207,415,417],{"className":283,"code":416,"language":285,"meta":215,"style":215},"curl -X POST https:\u002F\u002Fapi.pingonotify.com\u002Fv3\u002Fconnections\u002F{connectionId}\u002Fchats\u002Fmessages \\\n  -H \"apikey: sk_live_...\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"to\": \"5511999998888\",\n    \"text\": \"Olá, aqui é o Pingo\"\n  }'\n",[51,418,419,434,443,452,460,465,470],{"__ignoreMap":215},[289,420,421,423,426,429,432],{"class":291,"line":292},[289,422,296],{"class":295},[289,424,425],{"class":303}," -X",[289,427,428],{"class":299}," POST",[289,430,431],{"class":299}," https:\u002F\u002Fapi.pingonotify.com\u002Fv3\u002Fconnections\u002F{connectionId}\u002Fchats\u002Fmessages",[289,433,304],{"class":303},[289,435,436,438,441],{"class":291,"line":307},[289,437,310],{"class":303},[289,439,440],{"class":299}," \"apikey: sk_live_...\"",[289,442,304],{"class":303},[289,444,445,447,450],{"class":291,"line":334},[289,446,310],{"class":303},[289,448,449],{"class":299}," \"Content-Type: application\u002Fjson\"",[289,451,304],{"class":303},[289,453,454,457],{"class":291,"line":349},[289,455,456],{"class":303},"  -d",[289,458,459],{"class":299}," '{\n",[289,461,462],{"class":291,"line":362},[289,463,464],{"class":299},"    \"to\": \"5511999998888\",\n",[289,466,467],{"class":291,"line":375},[289,468,469],{"class":299},"    \"text\": \"Olá, aqui é o Pingo\"\n",[289,471,472],{"class":291,"line":390},[289,473,474],{"class":299},"  }'\n",[217,476,478],{"id":477},"como-as-peças-se-encaixam","Como as peças se encaixam",[197,480,481,482,485,486,490,491,494],{},"Uma ",[203,483,484],{},"conexão"," é um número de WhatsApp. Ela é ",[487,488,489],"em",{},"oficial"," (a Cloud API da Meta, usando as suas próprias credenciais da Meta) ou ",[487,492,493],{},"não oficial"," (uma conta real do WhatsApp pareada por QR code ou sync do navegador). Tudo que envia ou recebe mensagem roda, no fim, sobre uma conexão.",[197,496,497],{},"Você pode usar uma conexão de três formas, e elas se somam:",[499,500,501,507,513],"ol",{},[235,502,503,506],{},[203,504,505],{},"Diretamente."," Envie e leia mensagens na própria conexão — o mais parecido com a v2, e a escolha certa para notificações e mensagens transacionais.",[235,508,509,512],{},[203,510,511],{},"Por uma campanha."," Uma mensagem, muitos destinatários, ritmada para que um número não oficial não seja sinalizado, e medida contra o seu plano.",[235,514,515,518,519,522,523,526],{},[203,516,517],{},"Pelo helpdesk."," Vincule a conexão a uma ",[203,520,521],{},"caixa de entrada",", e as mensagens recebidas viram ",[203,524,525],{},"conversas"," que a sua equipe pode atribuir, etiquetar, adiar e responder — com bots, SLAs e relatórios por cima.",[197,528,529,530,533],{},"O helpdesk ainda tem um quarto tipo de caixa que não é um número de WhatsApp: o ",[203,531,532],{},"canal de API",", uma caixa programável na qual o seu próprio aplicativo injeta mensagens e da qual recebe as respostas por webhook. Ele permite colocar qualquer canal que você queira — um widget no site, um chat dentro do app, outro mensageiro — atrás da mesma caixa compartilhada.",[217,535,537],{"id":536},"a-única-coisa-que-você-precisa-saber-sobre-o-whatsapp","A única coisa que você precisa saber sobre o WhatsApp",[197,539,540,541,543,544,547],{},"O WhatsApp não deixa uma empresa mandar mensagem para alguém quando quiser. Em uma conexão ",[203,542,489],{},", passadas 24 horas desde a última mensagem do contato, você não pode mais enviar texto livre — só pode enviar um ",[203,545,546],{},"template"," que a Meta aprovou previamente.",[197,549,550,551,554],{},"A API é explícita quanto a isso. Enviar texto livre com a janela fechada retorna ",[203,552,553],{},"422",":",[207,556,558],{"className":316,"code":557,"language":318,"meta":215,"style":215},"{\n  \"statusCode\": 422,\n  \"message\": \"Outbound window expired — channel requires a pre-approved template\",\n  \"error\": \"Unprocessable Entity\"\n}\n",[51,559,560,565,576,588,598],{"__ignoreMap":215},[289,561,562],{"class":291,"line":292},[289,563,564],{"class":325},"{\n",[289,566,567,570,572,574],{"class":291,"line":307},[289,568,569],{"class":303},"  \"statusCode\"",[289,571,340],{"class":325},[289,573,553],{"class":303},[289,575,346],{"class":325},[289,577,578,581,583,586],{"class":291,"line":334},[289,579,580],{"class":303},"  \"message\"",[289,582,340],{"class":325},[289,584,585],{"class":299},"\"Outbound window expired — channel requires a pre-approved template\"",[289,587,346],{"class":325},[289,589,590,593,595],{"class":291,"line":349},[289,591,592],{"class":303},"  \"error\"",[289,594,340],{"class":325},[289,596,597],{"class":299},"\"Unprocessable Entity\"\n",[289,599,600],{"class":291,"line":362},[289,601,602],{"class":325},"}\n",[197,604,605,606,609],{},"Envie um template aprovado no lugar, e a janela reabre assim que o contato responder. Gerencie seus templates com ",[51,607,608],{},"GET \u002Fv3\u002Fconnections\u002F{id}\u002Ftemplates",".",[197,611,612],{},"Conexões não oficiais não têm essa janela.",[217,614,616],{"id":615},"por-onde-seguir","Por onde seguir",[618,619,620,626,631,637],"card-group",{"cols":307},[621,622,623],"card",{"icon":8,"title":81,"to":91},[197,624,625],{},"Seu token de API, a escolha do workspace, e o que cada papel pode fazer.",[621,627,628],{"icon":26,"title":95,"to":94},[197,629,630],{},"Paginação, erros, ids e datas — as regras que todo endpoint segue.",[621,632,634],{"icon":633,"title":16,"to":105},"bolt",[197,635,636],{},"Receba mensagens e eventos no seu servidor, e verifique que vieram de nós.",[621,638,639],{"icon":34,"title":102,"to":101},[197,640,641],{},"O websocket por trás da caixa de entrada compartilhada.",[643,644,645],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}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);}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":215,"searchDepth":334,"depth":334,"links":647},[648,649,650,651,652],{"id":219,"depth":307,"text":220},{"id":276,"depth":307,"text":277},{"id":477,"depth":307,"text":478},{"id":536,"depth":307,"text":537},{"id":615,"depth":307,"text":616},"md",{},true,{"title":85,"description":99},"pt-BR\u002Fapi-reference\u002Fv3\u002Findex","L9Fck1-bFi4jb2oUDLE9jABo5MYN73neDpbQksnC1BQ",{"left":143,"top":143,"width":149,"height":149,"rotate":143,"vFlip":145,"hFlip":145,"body":660},"\u003Cpath fill=\"currentColor\" d=\"M256 512a256 256 0 1 0 0-512a256 256 0 1 0 0 512m-40-176h24v-64h-24c-13.3 0-24-10.7-24-24s10.7-24 24-24h48c13.3 0 24 10.7 24 24v88h8c13.3 0 24 10.7 24 24s-10.7 24-24 24h-80c-13.3 0-24-10.7-24-24s10.7-24 24-24m40-208a32 32 0 1 1 0 64a32 32 0 1 1 0-64\"\u002F>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":662},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\" ry=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fg>",{"left":143,"top":143,"width":148,"height":149,"rotate":143,"vFlip":145,"hFlip":145,"body":664},"\u003Cpath fill=\"currentColor\" d=\"M349.4 44.6c5.9-13.7 1.5-29.7-10.6-38.5s-28.6-8-39.9 1.8l-256 224c-10 8.8-13.6 22.9-8.9 35.3S50.7 288 64 288h111.5L98.6 467.4c-5.9 13.7-1.5 29.7 10.6 38.5s28.6 8 39.9-1.8l256-224c10-8.8 13.6-22.9 8.9-35.3s-16.6-20.7-30-20.7H272.5z\"\u002F>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":666},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M5 12h14m-7-7l7 7l-7 7\"\u002F>",{"left":143,"top":143,"width":144,"height":144,"rotate":143,"vFlip":145,"hFlip":145,"body":668},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m9 18l6-6l-6-6\"\u002F>",1787698192308]