[{"data":1,"prerenderedAt":1718},["ShallowReactive",2],{"navigation_docs_pt":3,"-pt-api-api-channel":332,"-pt-api-api-channel-surround":1713},[4,8,26,52,94,124,173,187,197,223,233,243,288,318],{"title":5,"path":6,"stem":7},"Introdução","\u002Fpt\u002Fintroduction","pt\u002F01.introduction",{"title":9,"path":10,"stem":11,"children":12},"Começar","\u002Fpt\u002Fgetting-started","pt\u002F02.getting-started\u002Findex",[13,14,18,22],{"title":9,"path":10,"stem":11},{"title":15,"path":16,"stem":17},"Configuração inicial","\u002Fpt\u002Fgetting-started\u002Finitial-setup","pt\u002F02.getting-started\u002F01.initial-setup",{"title":19,"path":20,"stem":21},"Criar o primeiro agente","\u002Fpt\u002Fgetting-started\u002Ffirst-agent","pt\u002F02.getting-started\u002F02.first-agent",{"title":23,"path":24,"stem":25},"Fazer uma chamada de teste","\u002Fpt\u002Fgetting-started\u002Ftest-call","pt\u002F02.getting-started\u002F03.test-call",{"title":27,"path":28,"stem":29,"children":30},"Conceitos","\u002Fpt\u002Fconcepts","pt\u002F03.concepts\u002Findex",[31,32,36,40,44,48],{"title":27,"path":28,"stem":29},{"title":33,"path":34,"stem":35},"Agente de voz","\u002Fpt\u002Fconcepts\u002Fagent","pt\u002F03.concepts\u002F01.agent",{"title":37,"path":38,"stem":39},"Fluxo","\u002Fpt\u002Fconcepts\u002Fflow","pt\u002F03.concepts\u002F02.flow",{"title":41,"path":42,"stem":43},"Runtime","\u002Fpt\u002Fconcepts\u002Fruntime","pt\u002F03.concepts\u002F03.runtime",{"title":45,"path":46,"stem":47},"Organização e tenants","\u002Fpt\u002Fconcepts\u002Forganization","pt\u002F03.concepts\u002F04.organization",{"title":49,"path":50,"stem":51},"Prompt Builder","\u002Fpt\u002Fconcepts\u002Fprompt-builder","pt\u002F03.concepts\u002F05.prompt-builder",{"title":53,"path":54,"stem":55,"children":56},"Guias","\u002Fpt\u002Fguides","pt\u002F04.guides\u002Findex",[57,58,62,66,70,74,78,82,86,90],{"title":53,"path":54,"stem":55},{"title":59,"path":60,"stem":61},"Criar o primeiro agente passo a passo","\u002Fpt\u002Fguides\u002Fcreate-first-agent","pt\u002F04.guides\u002F01.create-first-agent",{"title":63,"path":64,"stem":65},"Usar o Flow Builder","\u002Fpt\u002Fguides\u002Fuse-flow-builder","pt\u002F04.guides\u002F02.use-flow-builder",{"title":67,"path":68,"stem":69},"Publicar e receber chamadas","\u002Fpt\u002Fguides\u002Fpublish-agent","pt\u002F04.guides\u002F03.publish-agent",{"title":71,"path":72,"stem":73},"Testar um agente","\u002Fpt\u002Fguides\u002Ftest-agent","pt\u002F04.guides\u002F04.test-agent",{"title":75,"path":76,"stem":77},"Transferir para humano","\u002Fpt\u002Fguides\u002Ftransfer-to-human","pt\u002F04.guides\u002F05.transfer-to-human",{"title":79,"path":80,"stem":81},"Marcar reuniões com Cal.com","\u002Fpt\u002Fguides\u002Fbook-meetings","pt\u002F04.guides\u002F06.book-meetings",{"title":83,"path":84,"stem":85},"Enviar SMS durante a chamada","\u002Fpt\u002Fguides\u002Fsend-sms","pt\u002F04.guides\u002F07.send-sms",{"title":87,"path":88,"stem":89},"Configurar um Phone Book","\u002Fpt\u002Fguides\u002Fconfigure-phone-book","pt\u002F04.guides\u002F08.configure-phone-book",{"title":91,"path":92,"stem":93},"Incorporar o widget de voz","\u002Fpt\u002Fguides\u002Fembed-widget","pt\u002F04.guides\u002F09.embed-widget",{"title":95,"path":96,"stem":97,"children":98},"Flow Builder","\u002Fpt\u002Fflow-builder","pt\u002F05.flow-builder\u002Findex",[99,100,104,108,112,116,120],{"title":95,"path":96,"stem":97},{"title":101,"path":102,"stem":103},"Interface do builder","\u002Fpt\u002Fflow-builder\u002Finterface","pt\u002F05.flow-builder\u002F01.interface",{"title":105,"path":106,"stem":107},"Estrutura de um fluxo","\u002Fpt\u002Fflow-builder\u002Fstructure","pt\u002F05.flow-builder\u002F02.structure",{"title":109,"path":110,"stem":111},"Variáveis do fluxo","\u002Fpt\u002Fflow-builder\u002Fvariables","pt\u002F05.flow-builder\u002F03.variables",{"title":113,"path":114,"stem":115},"Branches e condições","\u002Fpt\u002Fflow-builder\u002Fbranches","pt\u002F05.flow-builder\u002F04.branches",{"title":117,"path":118,"stem":119},"Testar um fluxo","\u002Fpt\u002Fflow-builder\u002Ftesting","pt\u002F05.flow-builder\u002F05.testing",{"title":121,"path":122,"stem":123},"Validação e publicação","\u002Fpt\u002Fflow-builder\u002Fvalidation-publishing","pt\u002F05.flow-builder\u002F06.validation-publishing",{"title":125,"path":126,"stem":127,"children":128},"Nós","\u002Fpt\u002Fnodes","pt\u002F06.nodes\u002Findex",[129,130,134,138,142,146,150,154,157,161,165,169],{"title":125,"path":126,"stem":127},{"title":131,"path":132,"stem":133},"Conversação","\u002Fpt\u002Fnodes\u002Fconversation","pt\u002F06.nodes\u002F01.conversation",{"title":135,"path":136,"stem":137},"Mensagem","\u002Fpt\u002Fnodes\u002Fmessage","pt\u002F06.nodes\u002F02.message",{"title":139,"path":140,"stem":141},"Dividir o caminho","\u002Fpt\u002Fnodes\u002Fsplit-path","pt\u002F06.nodes\u002F03.split-path",{"title":143,"path":144,"stem":145},"Saltar para","\u002Fpt\u002Fnodes\u002Fjump-to","pt\u002F06.nodes\u002F04.jump-to",{"title":147,"path":148,"stem":149},"Disparar subfluxo","\u002Fpt\u002Fnodes\u002Ftrigger-subflow","pt\u002F06.nodes\u002F05.trigger-subflow",{"title":151,"path":152,"stem":153},"Acção personalizada","\u002Fpt\u002Fnodes\u002Fcustom-action","pt\u002F06.nodes\u002F06.custom-action",{"title":83,"path":155,"stem":156},"\u002Fpt\u002Fnodes\u002Fsend-sms-during-call","pt\u002F06.nodes\u002F07.send-sms-during-call",{"title":158,"path":159,"stem":160},"Transferência","\u002Fpt\u002Fnodes\u002Ftransfer","pt\u002F06.nodes\u002F08.transfer",{"title":162,"path":163,"stem":164},"Agendamento","\u002Fpt\u002Fnodes\u002Fbooking","pt\u002F06.nodes\u002F09.booking",{"title":166,"path":167,"stem":168},"Terminar chamada","\u002Fpt\u002Fnodes\u002Fend-call","pt\u002F06.nodes\u002F10.end-call",{"title":170,"path":171,"stem":172},"Nós em breve","\u002Fpt\u002Fnodes\u002Fcoming-soon","pt\u002F06.nodes\u002F11.coming-soon",{"title":174,"path":175,"stem":176,"children":177},"Knowledge Base","\u002Fpt\u002Fknowledge-base","pt\u002F07.knowledge-base\u002Findex",[178,179,183],{"title":174,"path":175,"stem":176},{"title":180,"path":181,"stem":182},"Fontes","\u002Fpt\u002Fknowledge-base\u002Fsources","pt\u002F07.knowledge-base\u002F01.sources",{"title":184,"path":185,"stem":186},"Citações","\u002Fpt\u002Fknowledge-base\u002Fcitations","pt\u002F07.knowledge-base\u002F02.citations",{"title":188,"path":189,"stem":190,"children":191},"Test Center","\u002Fpt\u002Ftest-center","pt\u002F08.test-center\u002Findex",[192,193],{"title":188,"path":189,"stem":190},{"title":194,"path":195,"stem":196},"Avaliações","\u002Fpt\u002Ftest-center\u002Fevaluations","pt\u002F08.test-center\u002F01.evaluations",{"title":198,"path":199,"stem":200,"children":201},"API","\u002Fpt\u002Fapi","pt\u002F09.api\u002Findex",[202,203,207,211,215,219],{"title":198,"path":199,"stem":200},{"title":204,"path":205,"stem":206},"Canal API","\u002Fpt\u002Fapi\u002Fapi-channel","pt\u002F09.api\u002F01.api-channel",{"title":208,"path":209,"stem":210},"Autenticação","\u002Fpt\u002Fapi\u002Fauthentication","pt\u002F09.api\u002F02.authentication",{"title":212,"path":213,"stem":214},"Webhooks","\u002Fpt\u002Fapi\u002Fwebhooks","pt\u002F09.api\u002F03.webhooks",{"title":216,"path":217,"stem":218},"Endpoints","\u002Fpt\u002Fapi\u002Fendpoints","pt\u002F09.api\u002F04.endpoints",{"title":220,"path":221,"stem":222},"Realtime","\u002Fpt\u002Fapi\u002Frealtime","pt\u002F09.api\u002F05.realtime",{"title":224,"path":225,"stem":226,"children":227},"Integrações","\u002Fpt\u002Fintegrations","pt\u002F10.integrations\u002Findex",[228,229],{"title":224,"path":225,"stem":226},{"title":230,"path":231,"stem":232},"Cal.com","\u002Fpt\u002Fintegrations\u002Fcalcom","pt\u002F10.integrations\u002F01.calcom",{"title":234,"path":235,"stem":236,"children":237},"Telefonia","\u002Fpt\u002Ftelephony","pt\u002F11.telephony\u002Findex",[238,239],{"title":234,"path":235,"stem":236},{"title":240,"path":241,"stem":242},"Números de telefone","\u002Fpt\u002Ftelephony\u002Fnumbers","pt\u002F11.telephony\u002F01.numbers",{"title":244,"path":245,"stem":246,"children":247},"Definições","\u002Fpt\u002Fsettings","pt\u002F12.settings\u002Findex",[248,249,253,257,261,265,269,273,277,281,284],{"title":244,"path":245,"stem":246},{"title":250,"path":251,"stem":252},"Perfil pessoal","\u002Fpt\u002Fsettings\u002Fpersonal-profile","pt\u002F12.settings\u002F01.personal-profile",{"title":254,"path":255,"stem":256},"Credenciais","\u002Fpt\u002Fsettings\u002Fcredentials","pt\u002F12.settings\u002F02.credentials",{"title":258,"path":259,"stem":260},"Password","\u002Fpt\u002Fsettings\u002Fpassword","pt\u002F12.settings\u002F03.password",{"title":262,"path":263,"stem":264},"Autenticação de dois fatores","\u002Fpt\u002Fsettings\u002Ftwo-factor","pt\u002F12.settings\u002F04.two-factor",{"title":266,"path":267,"stem":268},"Sessões ativas","\u002Fpt\u002Fsettings\u002Fsessions","pt\u002F12.settings\u002F05.sessions",{"title":270,"path":271,"stem":272},"Empresa","\u002Fpt\u002Fsettings\u002Fcompany","pt\u002F12.settings\u002F06.company",{"title":274,"path":275,"stem":276},"Organização","\u002Fpt\u002Fsettings\u002Forganization","pt\u002F12.settings\u002F07.organization",{"title":278,"path":279,"stem":280},"Membros","\u002Fpt\u002Fsettings\u002Fmembers","pt\u002F12.settings\u002F08.members",{"title":224,"path":282,"stem":283},"\u002Fpt\u002Fsettings\u002Fintegrations","pt\u002F12.settings\u002F09.integrations",{"title":285,"path":286,"stem":287},"Chaves API","\u002Fpt\u002Fsettings\u002Fapi-keys","pt\u002F12.settings\u002F10.api-keys",{"title":289,"path":290,"stem":291,"children":292},"Troubleshooting","\u002Fpt\u002Ftroubleshooting","pt\u002F13.troubleshooting\u002Findex",[293,294,298,302,306,310,314],{"title":289,"path":290,"stem":291},{"title":295,"path":296,"stem":297},"Agente não atende","\u002Fpt\u002Ftroubleshooting\u002Fagent-not-answering","pt\u002F13.troubleshooting\u002F01.agent-not-answering",{"title":299,"path":300,"stem":301},"Chamadas caem","\u002Fpt\u002Ftroubleshooting\u002Fcalls-drop","pt\u002F13.troubleshooting\u002F02.calls-drop",{"title":303,"path":304,"stem":305},"Fluxo não publica","\u002Fpt\u002Ftroubleshooting\u002Fflow-not-publishing","pt\u002F13.troubleshooting\u002F03.flow-not-publishing",{"title":307,"path":308,"stem":309},"Knowledge Base não responde","\u002Fpt\u002Ftroubleshooting\u002Fkb-not-answering","pt\u002F13.troubleshooting\u002F04.kb-not-answering",{"title":311,"path":312,"stem":313},"Integração não liga","\u002Fpt\u002Ftroubleshooting\u002Fintegration-not-connecting","pt\u002F13.troubleshooting\u002F05.integration-not-connecting",{"title":315,"path":316,"stem":317},"Testes falham","\u002Fpt\u002Ftroubleshooting\u002Ftests-failing","pt\u002F13.troubleshooting\u002F06.tests-failing",{"title":319,"path":320,"stem":321,"children":322,"page":331},"Legal","\u002Fpt\u002Flegal","pt\u002F14.legal",[323,327],{"title":324,"path":325,"stem":326},"Política de Privacidade","\u002Fpt\u002Flegal\u002Fprivacy","pt\u002F14.legal\u002F01.privacy",{"title":328,"path":329,"stem":330},"Termos e Condições","\u002Fpt\u002Flegal\u002Fterms","pt\u002F14.legal\u002F02.terms",false,{"id":333,"title":204,"body":334,"description":1706,"extension":1707,"links":1708,"meta":1709,"navigation":1710,"path":205,"seo":1711,"stem":206,"__hash__":1712},"docs_pt\u002Fpt\u002F09.api\u002F01.api-channel.md",{"type":335,"value":336,"toc":1686},"minimark",[337,346,356,361,372,383,386,398,419,426,430,435,445,573,577,591,595,598,634,849,856,859,865,869,899,903,983,1024,1048,1081,1085,1133,1174,1180,1210,1232,1236,1268,1295,1299,1331,1335,1451,1454,1556,1561,1565,1586,1590,1666,1672,1675,1682],[338,339,340,341,345],"p",{},"O Canal API é a superfície REST pública da Diska: um conjunto de endpoints versionados, autenticados com as chaves API da organização, pensados para integrações servidor-a-servidor — sincronizar chamadas e transcrições com o seu CRM, criar e publicar agentes, alimentar bases de conhecimento e receber ",[342,343,344],"a",{"href":213},"webhooks de eventos"," sem polling.",[347,348,350,351,355],"callout",{"type":349},"info","Iniciar chamadas por API ainda não está disponível — chega com a telefonia de saída. Ver ",[342,352,354],{"href":353},"#futuro","futuro",".",[357,358,360],"h2",{"id":359},"base-url","Base URL",[362,363,369],"pre",{"className":364,"code":366,"language":367,"meta":368},[365],"language-text","https:\u002F\u002Fapi.diska.ai\u002Fv1\n","text","",[370,371,366],"code",{"__ignoreMap":368},[338,373,374,375,378,379,382],{},"Nota: a base do Canal API é ",[370,376,377],{},"\u002Fv1",", separada da API interna do backoffice (",[370,380,381],{},"\u002Fapi\u002Fv1","). Só os endpoints documentados nesta página aceitam chaves API.",[357,384,208],{"id":385},"autenticação",[338,387,388,389,393,394,397],{},"Crie uma chave em ",[390,391,392],"strong",{},"Definições → Chaves API"," no backoffice (a chave completa ",[370,395,396],{},"dsk_…"," só é mostrada uma vez). Envie-a em cada pedido:",[362,399,403],{"className":400,"code":401,"language":402,"meta":368,"style":368},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","GET \u002Fv1\u002Fagents\nAuthorization: Bearer dsk_a1b2c3…\n","http",[370,404,405,413],{"__ignoreMap":368},[406,407,410],"span",{"class":408,"line":409},"line",1,[406,411,412],{},"GET \u002Fv1\u002Fagents\n",[406,414,416],{"class":408,"line":415},2,[406,417,418],{},"Authorization: Bearer dsk_a1b2c3…\n",[338,420,421,422,425],{},"Em alternativa, o cabeçalho ",[370,423,424],{},"X-API-Key: dsk_…"," também é aceite.",[347,427,429],{"type":428},"warning","Guarde a chave em variáveis de ambiente no servidor; nunca a exponha em código frontend ou repositórios. Se for comprometida, revogue-a em Definições → Chaves API — deixa de funcionar imediatamente.",[431,432,434],"h3",{"id":433},"âmbitos-scopes","Âmbitos (scopes)",[338,436,437,438,441,442,355],{},"Ao criar a chave pode restringi-la a âmbitos específicos. ",[390,439,440],{},"Uma chave sem âmbitos tem acesso total"," (o contrato original); com âmbitos, só esses endpoints respondem — os restantes devolvem ",[370,443,444],{},"403",[446,447,448,461],"table",{},[449,450,451],"thead",{},[452,453,454,458],"tr",{},[455,456,457],"th",{},"Âmbito",[455,459,460],{},"Dá acesso a",[462,463,464,481,496,511,523,535,547,560],"tbody",{},[452,465,466,472],{},[467,468,469],"td",{},[370,470,471],{},"agents:read",[467,473,474,477,478],{},[370,475,476],{},"GET \u002Fv1\u002Fagents",", ",[370,479,480],{},"GET \u002Fv1\u002Fagents\u002F{id}",[452,482,483,488],{},[467,484,485],{},[370,486,487],{},"agents:write",[467,489,490,477,493],{},[370,491,492],{},"POST \u002Fv1\u002Fagents",[370,494,495],{},"POST \u002Fv1\u002Fagents\u002F{id}\u002Fpublish",[452,497,498,503],{},[467,499,500],{},[370,501,502],{},"calls:read",[467,504,505,477,508],{},[370,506,507],{},"GET \u002Fv1\u002Fcalls",[370,509,510],{},"GET \u002Fv1\u002Fcalls\u002F{id}",[452,512,513,518],{},[467,514,515],{},[370,516,517],{},"analytics:read",[467,519,520],{},[370,521,522],{},"GET \u002Fv1\u002Fanalytics\u002Foverview",[452,524,525,530],{},[467,526,527],{},[370,528,529],{},"phone-numbers:read",[467,531,532],{},[370,533,534],{},"GET \u002Fv1\u002Fphone-numbers",[452,536,537,542],{},[467,538,539],{},[370,540,541],{},"knowledge:read",[467,543,544],{},[370,545,546],{},"GET \u002Fv1\u002Fknowledge-bases",[452,548,549,554],{},[467,550,551],{},[370,552,553],{},"knowledge:write",[467,555,556,559],{},[370,557,558],{},"POST \u002Fv1\u002Fknowledge-bases"," e ingestão de documentos",[452,561,562,567],{},[467,563,564],{},[370,565,566],{},"webhooks:manage",[467,568,569,570],{},"Gestão de ",[370,571,572],{},"\u002Fv1\u002Fwebhook-endpoints",[431,574,576],{"id":575},"expiração","Expiração",[338,578,579,580,583,584,587,588,590],{},"Uma chave pode ter ",[370,581,582],{},"expires_at"," (definido na criação). Depois dessa data responde ",[370,585,586],{},"401"," com \"Chave de API expirada\". Sem ",[370,589,582],{},", a chave vale até ser revogada.",[357,592,594],{"id":593},"primeiro-pedido","Primeiro pedido",[338,596,597],{},"Confirme a que organização e chave o token pertence:",[362,599,603],{"className":600,"code":601,"language":602,"meta":368,"style":368},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl https:\u002F\u002Fapi.diska.ai\u002Fv1\u002Fme \\\n  -H \"Authorization: Bearer dsk_a1b2c3…\"\n","bash",[370,604,605,619],{"__ignoreMap":368},[406,606,607,611,615],{"class":408,"line":409},[406,608,610],{"class":609},"sBMFI","curl",[406,612,614],{"class":613},"sfazB"," https:\u002F\u002Fapi.diska.ai\u002Fv1\u002Fme",[406,616,618],{"class":617},"sTEyZ"," \\\n",[406,620,621,624,628,631],{"class":408,"line":415},[406,622,623],{"class":613},"  -H",[406,625,627],{"class":626},"sMK4o"," \"",[406,629,630],{"class":613},"Authorization: Bearer dsk_a1b2c3…",[406,632,633],{"class":626},"\"\n",[362,635,639],{"className":636,"code":637,"language":638,"meta":368,"style":368},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"organization\": { \"id\": \"…\", \"name\": \"A Minha Empresa\", \"slug\": \"a-minha-empresa\" },\n  \"key\": { \"id\": \"…\", \"name\": \"Integração CRM\", \"key_preview\": \"dsk_a1b2…F5A4\", \"scopes\": [], \"expires_at\": null, \"created_at\": \"…\", \"last_used_at\": \"…\" }\n}\n","json",[370,640,641,646,720,843],{"__ignoreMap":368},[406,642,643],{"class":408,"line":409},[406,644,645],{"class":626},"{\n",[406,647,648,651,655,658,661,664,666,669,671,673,675,678,680,683,685,688,690,692,694,697,699,701,703,706,708,710,712,715,717],{"class":408,"line":415},[406,649,650],{"class":626},"  \"",[406,652,654],{"class":653},"spNyl","organization",[406,656,657],{"class":626},"\"",[406,659,660],{"class":626},":",[406,662,663],{"class":626}," {",[406,665,627],{"class":626},[406,667,668],{"class":609},"id",[406,670,657],{"class":626},[406,672,660],{"class":626},[406,674,627],{"class":626},[406,676,677],{"class":613},"…",[406,679,657],{"class":626},[406,681,682],{"class":626},",",[406,684,627],{"class":626},[406,686,687],{"class":609},"name",[406,689,657],{"class":626},[406,691,660],{"class":626},[406,693,627],{"class":626},[406,695,696],{"class":613},"A Minha Empresa",[406,698,657],{"class":626},[406,700,682],{"class":626},[406,702,627],{"class":626},[406,704,705],{"class":609},"slug",[406,707,657],{"class":626},[406,709,660],{"class":626},[406,711,627],{"class":626},[406,713,714],{"class":613},"a-minha-empresa",[406,716,657],{"class":626},[406,718,719],{"class":626}," },\n",[406,721,723,725,728,730,732,734,736,738,740,742,744,746,748,750,752,754,756,758,760,763,765,767,769,772,774,776,778,781,783,785,787,790,792,794,797,799,801,803,805,808,810,813,815,817,819,821,823,825,827,830,832,834,836,838,840],{"class":408,"line":722},3,[406,724,650],{"class":626},[406,726,727],{"class":653},"key",[406,729,657],{"class":626},[406,731,660],{"class":626},[406,733,663],{"class":626},[406,735,627],{"class":626},[406,737,668],{"class":609},[406,739,657],{"class":626},[406,741,660],{"class":626},[406,743,627],{"class":626},[406,745,677],{"class":613},[406,747,657],{"class":626},[406,749,682],{"class":626},[406,751,627],{"class":626},[406,753,687],{"class":609},[406,755,657],{"class":626},[406,757,660],{"class":626},[406,759,627],{"class":626},[406,761,762],{"class":613},"Integração CRM",[406,764,657],{"class":626},[406,766,682],{"class":626},[406,768,627],{"class":626},[406,770,771],{"class":609},"key_preview",[406,773,657],{"class":626},[406,775,660],{"class":626},[406,777,627],{"class":626},[406,779,780],{"class":613},"dsk_a1b2…F5A4",[406,782,657],{"class":626},[406,784,682],{"class":626},[406,786,627],{"class":626},[406,788,789],{"class":609},"scopes",[406,791,657],{"class":626},[406,793,660],{"class":626},[406,795,796],{"class":626}," [],",[406,798,627],{"class":626},[406,800,582],{"class":609},[406,802,657],{"class":626},[406,804,660],{"class":626},[406,806,807],{"class":626}," null,",[406,809,627],{"class":626},[406,811,812],{"class":609},"created_at",[406,814,657],{"class":626},[406,816,660],{"class":626},[406,818,627],{"class":626},[406,820,677],{"class":613},[406,822,657],{"class":626},[406,824,682],{"class":626},[406,826,627],{"class":626},[406,828,829],{"class":609},"last_used_at",[406,831,657],{"class":626},[406,833,660],{"class":626},[406,835,627],{"class":626},[406,837,677],{"class":613},[406,839,657],{"class":626},[406,841,842],{"class":626}," }\n",[406,844,846],{"class":408,"line":845},4,[406,847,848],{"class":626},"}\n",[338,850,851,852,855],{},"A especificação OpenAPI completa do canal está disponível em ",[370,853,854],{},"GET \u002Fv1\u002Fopenapi.json"," (sem autenticação) — importe-a no Postman ou gere um cliente tipado.",[357,857,216],{"id":858},"endpoints",[338,860,861,862,355],{},"Todos os endpoints devolvem JSON. Os recursos pertencem sempre à organização da chave — identificadores de outra organização respondem ",[370,863,864],{},"404",[431,866,868],{"id":867},"identidade","Identidade",[446,870,871,884],{},[449,872,873],{},[452,874,875,878,881],{},[455,876,877],{},"Método",[455,879,880],{},"Caminho",[455,882,883],{},"Descrição",[462,885,886],{},[452,887,888,891,896],{},[467,889,890],{},"GET",[467,892,893],{},[370,894,895],{},"\u002Fv1\u002Fme",[467,897,898],{},"Organização e chave por trás do token.",[431,900,902],{"id":901},"agentes","Agentes",[446,904,905,917],{},[449,906,907],{},[452,908,909,911,913,915],{},[455,910,877],{},[455,912,880],{},[455,914,457],{},[455,916,883],{},[462,918,919,935,951,967],{},[452,920,921,923,928,932],{},[467,922,890],{},[467,924,925],{},[370,926,927],{},"\u002Fv1\u002Fagents",[467,929,930],{},[370,931,471],{},[467,933,934],{},"Lista os agentes da organização.",[452,936,937,939,944,948],{},[467,938,890],{},[467,940,941],{},[370,942,943],{},"\u002Fv1\u002Fagents\u002F{agent_id}",[467,945,946],{},[370,947,471],{},[467,949,950],{},"Detalhe de um agente.",[452,952,953,956,960,964],{},[467,954,955],{},"POST",[467,957,958],{},[370,959,927],{},[467,961,962],{},[370,963,487],{},[467,965,966],{},"Cria um agente (rascunho).",[452,968,969,971,976,980],{},[467,970,955],{},[467,972,973],{},[370,974,975],{},"\u002Fv1\u002Fagents\u002F{agent_id}\u002Fpublish",[467,977,978],{},[370,979,487],{},[467,981,982],{},"Publica o rascunho como versão live.",[338,984,985,986,988,989,992,993,477,996,477,999,477,1002,1005,1006,992,1009,477,1012,477,1015,477,1018,1005,1021,355],{},"Parâmetros de ",[370,987,476],{},": ",[370,990,991],{},"agent_type"," (",[370,994,995],{},"inbound",[370,997,998],{},"outbound",[370,1000,1001],{},"voice_widget",[370,1003,1004],{},"chat","), ",[370,1007,1008],{},"status",[370,1010,1011],{},"draft",[370,1013,1014],{},"active",[370,1016,1017],{},"inactive",[370,1019,1020],{},"archived",[370,1022,1023],{},"search",[338,1025,1026,1027,988,1029,477,1031,477,1033,992,1036,1039,1040,1043,1044,1047],{},"Corpo de ",[370,1028,492],{},[370,1030,687],{},[370,1032,991],{},[370,1034,1035],{},"editing_mode",[370,1037,1038],{},"prompt"," | ",[370,1041,1042],{},"flow",") e, opcionalmente, ",[370,1045,1046],{},"template_id"," para instalar a partir de um modelo. O agente nasce como rascunho — publique-o para o tornar utilizável.",[338,1049,1050,1051,477,1053,477,1055,477,1057,477,1060,477,1062,477,1064,477,1066,477,1069,477,1072,477,1075,477,1077,1080],{},"Cada agente devolve os campos operacionais (",[370,1052,668],{},[370,1054,687],{},[370,1056,705],{},[370,1058,1059],{},"description",[370,1061,1008],{},[370,1063,991],{},[370,1065,1035],{},[370,1067,1068],{},"version",[370,1070,1071],{},"phone_number",[370,1073,1074],{},"public_channel_enabled",[370,1076,812],{},[370,1078,1079],{},"updated_at",") — a configuração interna do builder não é exposta.",[431,1082,1084],{"id":1083},"chamadas","Chamadas",[446,1086,1087,1099],{},[449,1088,1089],{},[452,1090,1091,1093,1095,1097],{},[455,1092,877],{},[455,1094,880],{},[455,1096,457],{},[455,1098,883],{},[462,1100,1101,1117],{},[452,1102,1103,1105,1110,1114],{},[467,1104,890],{},[467,1106,1107],{},[370,1108,1109],{},"\u002Fv1\u002Fcalls",[467,1111,1112],{},[370,1113,502],{},[467,1115,1116],{},"Lista chamadas (paginação por offset ou cursor).",[452,1118,1119,1121,1126,1130],{},[467,1120,890],{},[467,1122,1123],{},[370,1124,1125],{},"\u002Fv1\u002Fcalls\u002F{call_id}",[467,1127,1128],{},[370,1129,502],{},[467,1131,1132],{},"Detalhe: transcrição completa, acções executadas e resultado pós-chamada.",[338,1134,985,1135,988,1137,477,1139,477,1142,992,1144,477,1147,477,1149,477,1152,477,1155,477,1158,1005,1161,477,1164,1167,1168,477,1171,355],{},[370,1136,1109],{},[370,1138,1023],{},[370,1140,1141],{},"agent_id",[370,1143,1008],{},[370,1145,1146],{},"created",[370,1148,1014],{},[370,1150,1151],{},"completed",[370,1153,1154],{},"failed",[370,1156,1157],{},"cancelled",[370,1159,1160],{},"abandoned",[370,1162,1163],{},"channel",[370,1165,1166],{},"limit"," (1–200, padrão 50), ",[370,1169,1170],{},"offset",[370,1172,1173],{},"cursor",[338,1175,1176,1179],{},[390,1177,1178],{},"Paginação por cursor"," (recomendada para exportar históricos grandes — custo constante a qualquer profundidade):",[1181,1182,1183,1190,1200],"ol",{},[1184,1185,1186,1187,355],"li",{},"Primeiro pedido: ",[370,1188,1189],{},"GET \u002Fv1\u002Fcalls?cursor=start&limit=100",[1184,1191,1192,1193,1196,1197,355],{},"A resposta traz ",[370,1194,1195],{},"next_cursor","; repita com ",[370,1198,1199],{},"cursor=\u003Cnext_cursor>",[1184,1201,1202,1203,1205,1206,1209],{},"Quando ",[370,1204,1195],{}," for ",[370,1207,1208],{},"null",", chegou ao fim.",[338,1211,1212,1213,1216,1217,1219,1220,1222,1223,1225,1226,1228,1229,1231],{},"Em modo cursor, ",[370,1214,1215],{},"total"," vem ",[370,1218,1208],{}," (contar exigiria o varrimento completo que o cursor evita) e ",[370,1221,1023],{}," não é suportado. O modo offset clássico (",[370,1224,1166],{},"\u002F",[370,1227,1170],{}," com ",[370,1230,1215],{}," exacto) continua disponível.",[431,1233,1235],{"id":1234},"análises","Análises",[446,1237,1238,1250],{},[449,1239,1240],{},[452,1241,1242,1244,1246,1248],{},[455,1243,877],{},[455,1245,880],{},[455,1247,457],{},[455,1249,883],{},[462,1251,1252],{},[452,1253,1254,1256,1261,1265],{},[467,1255,890],{},[467,1257,1258],{},[370,1259,1260],{},"\u002Fv1\u002Fanalytics\u002Foverview",[467,1262,1263],{},[370,1264,517],{},[467,1266,1267],{},"Volume, resultados, desempenho por agente e acções executadas.",[338,1269,1270,1271,992,1274,477,1277,477,1280,1005,1283,477,1285,992,1287,477,1290,477,1292,1294],{},"Parâmetros: ",[370,1272,1273],{},"period",[370,1275,1276],{},"daily",[370,1278,1279],{},"weekly",[370,1281,1282],{},"monthly",[370,1284,1141],{},[370,1286,991],{},[370,1288,1289],{},"all",[370,1291,995],{},[370,1293,998],{},").",[431,1296,1298],{"id":1297},"números","Números",[446,1300,1301,1313],{},[449,1302,1303],{},[452,1304,1305,1307,1309,1311],{},[455,1306,877],{},[455,1308,880],{},[455,1310,457],{},[455,1312,883],{},[462,1314,1315],{},[452,1316,1317,1319,1324,1328],{},[467,1318,890],{},[467,1320,1321],{},[370,1322,1323],{},"\u002Fv1\u002Fphone-numbers",[467,1325,1326],{},[370,1327,529],{},[467,1329,1330],{},"Inventário de números da organização.",[431,1332,1334],{"id":1333},"conhecimento","Conhecimento",[446,1336,1337,1349],{},[449,1338,1339],{},[452,1340,1341,1343,1345,1347],{},[455,1342,877],{},[455,1344,880],{},[455,1346,457],{},[455,1348,883],{},[462,1350,1351,1367,1389,1411,1432],{},[452,1352,1353,1355,1360,1364],{},[467,1354,890],{},[467,1356,1357],{},[370,1358,1359],{},"\u002Fv1\u002Fknowledge-bases",[467,1361,1362],{},[370,1363,541],{},[467,1365,1366],{},"Bases de conhecimento (nome, instrução, contagens).",[452,1368,1369,1371,1375,1379],{},[467,1370,955],{},[467,1372,1373],{},[370,1374,1359],{},[467,1376,1377],{},[370,1378,553],{},[467,1380,1381,1382,477,1384,477,1387,1294],{},"Cria uma base (",[370,1383,687],{},[370,1385,1386],{},"instruction",[370,1388,1059],{},[452,1390,1391,1393,1398,1402],{},[467,1392,955],{},[467,1394,1395],{},[370,1396,1397],{},"\u002Fv1\u002Fknowledge-bases\u002F{id}\u002Fdocuments",[467,1399,1400],{},[370,1401,553],{},[467,1403,1404,1405,477,1407,1410],{},"Documento manual (",[370,1406,687],{},[370,1408,1409],{},"content","); a indexação arranca automaticamente.",[452,1412,1413,1415,1420,1424],{},[467,1414,955],{},[467,1416,1417],{},[370,1418,1419],{},"\u002Fv1\u002Fknowledge-bases\u002F{id}\u002Fdocuments\u002Furl",[467,1421,1422],{},[370,1423,553],{},[467,1425,1426,1427,477,1429,1294],{},"Importa uma página web pública (",[370,1428,687],{},[370,1430,1431],{},"url",[452,1433,1434,1436,1441,1445],{},[467,1435,955],{},[467,1437,1438],{},[370,1439,1440],{},"\u002Fv1\u002Fknowledge-bases\u002F{id}\u002Fdocuments\u002Fpdf",[467,1442,1443],{},[370,1444,553],{},[467,1446,1447,1448,1294],{},"Upload de PDF (multipart, campo ",[370,1449,1450],{},"file",[431,1452,212],{"id":1453},"webhooks",[446,1455,1456,1468],{},[449,1457,1458],{},[452,1459,1460,1462,1464,1466],{},[455,1461,877],{},[455,1463,880],{},[455,1465,457],{},[455,1467,883],{},[462,1469,1470,1485,1500,1520,1536],{},[452,1471,1472,1474,1478,1482],{},[467,1473,890],{},[467,1475,1476],{},[370,1477,572],{},[467,1479,1480],{},[370,1481,566],{},[467,1483,1484],{},"Lista endpoints registados (com estado de entrega).",[452,1486,1487,1489,1493,1497],{},[467,1488,955],{},[467,1490,1491],{},[370,1492,572],{},[467,1494,1495],{},[370,1496,566],{},[467,1498,1499],{},"Regista um endpoint https; devolve o secret uma única vez.",[452,1501,1502,1505,1510,1514],{},[467,1503,1504],{},"PATCH",[467,1506,1507],{},[370,1508,1509],{},"\u002Fv1\u002Fwebhook-endpoints\u002F{id}",[467,1511,1512],{},[370,1513,566],{},[467,1515,1516,1517,1294],{},"Actualiza url\u002Feventos\u002Fdescrição ou reactiva (",[370,1518,1519],{},"active: true",[452,1521,1522,1525,1529,1533],{},[467,1523,1524],{},"DELETE",[467,1526,1527],{},[370,1528,1509],{},[467,1530,1531],{},[370,1532,566],{},[467,1534,1535],{},"Remove o endpoint.",[452,1537,1538,1540,1545,1549],{},[467,1539,955],{},[467,1541,1542],{},[370,1543,1544],{},"\u002Fv1\u002Fwebhook-endpoints\u002F{id}\u002Ftest",[467,1546,1547],{},[370,1548,566],{},[467,1550,1551,1552,1555],{},"Envia um ",[370,1553,1554],{},"ping"," assinado para validar o receptor.",[338,1557,1558,1559,355],{},"Eventos, assinatura HMAC e política de retries: ver ",[342,1560,212],{"href":213},[357,1562,1564],{"id":1563},"limites-de-utilização","Limites de utilização",[338,1566,1567,1568,1571,1572,1575,1576,477,1579,1582,1583,355],{},"Os pedidos são limitados por chave (por omissão 120 pedidos\u002Fminuto; chaves podem ter um limite próprio definido na criação via ",[370,1569,1570],{},"rate_limit_per_minute","). Acima do limite, a API responde ",[370,1573,1574],{},"429"," com os cabeçalhos ",[370,1577,1578],{},"Retry-After",[370,1580,1581],{},"X-RateLimit-Limit"," e ",[370,1584,1585],{},"X-RateLimit-Remaining",[357,1587,1589],{"id":1588},"erros","Erros",[446,1591,1592,1602],{},[449,1593,1594],{},[452,1595,1596,1599],{},[455,1597,1598],{},"Código",[455,1600,1601],{},"Significado",[462,1603,1604,1612,1619,1626,1633,1641,1649,1658],{},[452,1605,1606,1609],{},[467,1607,1608],{},"400",[467,1610,1611],{},"Pedido inválido (cursor malformado, URL de webhook rejeitado, âmbito desconhecido…).",[452,1613,1614,1616],{},[467,1615,586],{},[467,1617,1618],{},"Chave em falta, inválida, revogada ou expirada.",[452,1620,1621,1623],{},[467,1622,444],{},[467,1624,1625],{},"Organização suspensa, ou a chave não tem o âmbito necessário.",[452,1627,1628,1630],{},[467,1629,864],{},[467,1631,1632],{},"Recurso inexistente ou de outra organização.",[452,1634,1635,1638],{},[467,1636,1637],{},"409",[467,1639,1640],{},"Conflito (ex.: publicar um agente arquivado).",[452,1642,1643,1646],{},[467,1644,1645],{},"422",[467,1647,1648],{},"Validação falhou (ex.: publicar um agente com fluxo inválido).",[452,1650,1651,1653],{},[467,1652,1574],{},[467,1654,1655,1656,355],{},"Limite de pedidos excedido — respeite o ",[370,1657,1578],{},[452,1659,1660,1663],{},[467,1661,1662],{},"502\u002F503",[467,1664,1665],{},"Falha temporária a montante — repita com backoff.",[338,1667,1668,1669,355],{},"O corpo do erro segue o formato FastAPI: ",[370,1670,1671],{},"{ \"detail\": \"…\" }",[357,1673,1674],{"id":354},"Futuro",[338,1676,1677,1678,1681],{},"Nas próximas iterações do canal estão previstos: iniciar chamadas por API (quando a telefonia de saída estiver ligada), eventos de webhook adicionais (",[370,1679,1680],{},"call.failed",", estados em tempo real), gestão programática de chaves e exportações em massa.",[1683,1684,1685],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}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 .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}",{"title":368,"searchDepth":415,"depth":415,"links":1687},[1688,1689,1693,1694,1703,1704,1705],{"id":359,"depth":415,"text":360},{"id":385,"depth":415,"text":208,"children":1690},[1691,1692],{"id":433,"depth":722,"text":434},{"id":575,"depth":722,"text":576},{"id":593,"depth":415,"text":594},{"id":858,"depth":415,"text":216,"children":1695},[1696,1697,1698,1699,1700,1701,1702],{"id":867,"depth":722,"text":868},{"id":901,"depth":722,"text":902},{"id":1083,"depth":722,"text":1084},{"id":1234,"depth":722,"text":1235},{"id":1297,"depth":722,"text":1298},{"id":1333,"depth":722,"text":1334},{"id":1453,"depth":722,"text":212},{"id":1563,"depth":415,"text":1564},{"id":1588,"depth":415,"text":1589},{"id":354,"depth":415,"text":1674},"Aceda aos dados da sua organização por REST com chaves API.","md",null,{},true,{"title":204,"description":1706},"i5K7_mPFeU6ATrmjkbDdhs4KmyXOcGQdkqjPfNLCJ8c",[1714,1716],{"title":198,"path":199,"stem":200,"description":1715,"children":-1},"Integre a Diska por REST com chaves API — agentes, chamadas, análises e webhooks.",{"title":208,"path":209,"stem":210,"description":1717,"children":-1},"Chaves API para integrações e sessões Better Auth para o backoffice.",1786954553222]