Este guia apresenta tudo o que você precisa para utilizar o recurso de ligações do Z-API, abordando as três formas de integração disponíveis: API , SDK e protocolo SIP.As ligações via WhatsApp permitem interações em tempo real, de forma simples e integrada ao fluxo de atendimento já existente. Com o Z-API, você pode realizar e gerenciar ligações de diferentes formas:
Via API: Envio de arquivos de audio via requisições no Z-API
Via SDK: Conjunto de ferramentas, bibliotecas e métodos prontos que o Z-API disponibiliza para facilitar a integração nas suas aplicações.
Via SIP: Conexão de infraestrutura de telefonia como PABX, VOIP com o Whatsapp
É importante destacar que cada método possui características, requisitos e casos de uso específicos. O objetivo deste guia é apresentar cada abordagem de forma clara e prática, ajudando desenvolvedores e equipes técnicas a escolherem e implementarem a solução mais adequada para o seu cenário.
O recurso de ligações via API permite o envio de áudios pré-gravados como ligação no WhatsApp, possibilitando a automação de chamadas por meio de requisições HTTP simples, sem necessidade de bibliotecas adicionais.A documentação completa do endpoint está disponível em:🔗 https://developer.z-api.io/calls/send-call
O SDK (Software Development Kit) é um conjunto de bibliotecas e métodos disponibilizados pelo Z-API para facilitar a integração nas suas aplicações. Em vez de montar manualmente as requisições HTTP, o SDK abstrai essa complexidade, oferecendo funções prontas e intuitivas para realizar ações como iniciar uma ligação, monitorar eventos e tratar erros.Para o recurso de ligações, o SDK vai além do envio de áudios pré-gravados — ele permite realizar ligações de vídeo e ligações ao vivo, com suporte a até 3 chamadas simultâneas, tornando-o ideal para cenários de atendimento em tempo real e comunicação mais rica com o cliente.
Importante: para utilizar o recurso de ligações via SDK, é necessário
primeiramente solicitar o token de ligação e realizar a inicialização do SDK
antes de efetuar qualquer chamada.
Após gerar o token, siga exemplo de inicialização do SDK:
import { init } from "@z-api/call";const client = init({ instanceId: "SUA_INSTANCE_ID", getToken: async () => { // Chama SEU backend, que por sua vez chama a Z-API para obter o token efêmero const res = await fetch("https://seu-backend.com/call-token"); const data = await res.json(); return data.token; },});// Ouvir eventosclient.on("call:incoming", (call) => { console.log("Chamada recebida de", call.from);});client.on("connected", () => { console.log("Conectado ao servidor");});
O SIP (Session Initiation Protocol) é um protocolo de comunicação padrão da indústria de telefonia, utilizado para iniciar, manter e encerrar sessões de voz e vídeo via internet (VoIP).No contexto do Z-API, a integração via SIP permite que empresas que já possuem infraestrutura de telefonia como PABX IP, softphones ou provedores VoIP conectem essa estrutura ao WhatsApp, realizando ligações diretamente pela sua plataforma sem depender de um dispositivo físico.
O recurso de ligações do Z-API foi desenvolvido para atender diferentes perfis de integração, desde automações simples até operações mais complexas de telefonia. A escolha do método ideal depende das necessidades do seu projeto e da estrutura técnica disponível.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"Z-API Docs","colors":{"primary":"#00B140","light":"#00D455","dark":"#007A2C"},"logo":{"light":"https://staging.z-api.io/logos/SVG/Ativo%2016.svg","dark":"https://staging.z-api.io/logos/SVG/Ativo%2016.svg"},"favicon":"https://mintcdn.com/z-api-8aa3bb40/5Sj9mIPH3KokDXt2/favicon.png?fit=max\u0026auto=format\u0026n=5Sj9mIPH3KokDXt2\u0026q=85\u0026s=0ee09d9d5aa6a2ffd98d0e3a7335da05","api":{"examples":{"defaults":"required"},"mdx":{"auth":{"method":"key","name":"Client-Token"},"server":"https://api.z-api.io"}},"background":{"color":{"dark":"#14161f"}},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"poimandres"}},"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://www.z-api.io/blog"},{"anchor":"YouTube","icon":"youtube","href":"https://www.youtube.com/@z_api"},{"anchor":"Postman","icon":"rocket","href":"https://www.postman.com/docs-z-api/z-api-s-public-workspace/collection/gwri249/z-api-collection"},{"anchor":"WhatsApp","icon":"whatsapp","href":"https://chat.whatsapp.com/KmE3atZGmWJEspMZnBZKjV"}]},"languages":[{"language":"pt-BR","default":true,"navbar":{"links":[{"href":"https://api.whatsapp.com/send?phone=554431421722\u0026text=Ol%C3%A1,%20gostaria%20de%20falar%20com%20o%20suporte%20da%20Z-API","label":"Suporte"}],"primary":{"type":"button","label":"Painel","href":"https://app.z-api.io/"}},"href":"quickstart/introduction"},{"language":"en","navbar":{"links":[{"href":"https://api.whatsapp.com/send?phone=554431421722\u0026text=Hello,%20I%20would%20like%20to%20talk%20to%20Z-API%20support","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.z-api.io/"}},"href":"en/quickstart/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"z-api-8aa3bb40","hasAudioNarration":false,"actualSubdomain":"z-api-8aa3bb40","customDomains":["developer.z-api.io"],"gitSource":{"type":"github","owner":"z-api","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ac7ca8e5b1873d75a4a0d69","collectionId":"25f87f2e-0dc7-4286-98f6-4f20171c13ea","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac7ca8e5b1873d75a4a0d69"},"entitlements":{},"buildId":"6ac7ca8e5b1873d75a4a0d69","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"pt-BR","tag":"API Reference","count":499},{"language":"en","tag":"API Reference","count":499},{"language":"pt-BR","tag":"Messages","count":42},{"language":"en","tag":"Messages","count":42},{"language":"pt-BR","tag":"WhatsApp Business","count":32},{"language":"en","tag":"WhatsApp Business","count":32},{"language":"pt-BR","tag":"Groups","count":23},{"language":"en","tag":"Groups","count":23},{"language":"pt-BR","tag":"Instance","count":22},{"language":"en","tag":"Instance","count":22},{"language":"pt-BR","tag":"Documentação","count":21},{"language":"en","tag":"Documentation","count":21},{"language":"pt-BR","tag":"Newsletter","count":19},{"language":"en","tag":"Newsletter","count":19},{"language":"pt-BR","tag":"Mobile","count":16},{"language":"en","tag":"Mobile","count":16},{"language":"pt-BR","tag":"Communities","count":14},{"language":"pt-BR","tag":"Webhooks","count":14},{"language":"en","tag":"Communities","count":14},{"language":"en","tag":"Webhooks","count":14}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"tips/calls-guide","slug":"/tips/calls-guide","pageMetadata":{"title":"Ligações no Z-API Guia Completo","description":null,"href":"/tips/calls-guide"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,OptimizedImage,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`introdução`,children:`Introdução`}),`\n`,_jsx(_components.p,{children:`Este guia apresenta tudo o que você precisa para utilizar o recurso de ligações do Z-API, abordando as três formas de integração disponíveis: API , SDK e protocolo SIP.`}),`\n`,_jsx(_components.p,{children:`As ligações via WhatsApp permitem interações em tempo real, de forma simples e integrada ao fluxo de atendimento já existente. Com o Z-API, você pode realizar e gerenciar ligações de diferentes formas:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Via API: Envio de arquivos de audio via requisições no Z-API`}),`\n`,_jsx(_components.li,{children:`Via SDK: Conjunto de ferramentas, bibliotecas e métodos prontos que o Z-API disponibiliza para facilitar a integração nas suas aplicações.`}),`\n`,_jsx(_components.li,{children:`Via SIP: Conexão de infraestrutura de telefonia como PABX, VOIP com o Whatsapp`}),`\n`]}),`\n`,_jsx(_components.p,{children:`É importante destacar que cada método possui características, requisitos e casos de uso específicos. O objetivo deste guia é apresentar cada abordagem de forma clara e prática, ajudando desenvolvedores e equipes técnicas a escolherem e implementarem a solução mais adequada para o seu cenário.`}),`\n`,_jsx(Heading,{level:`2`,id:`1-via-api`,children:`1. Via API`}),`\n`,_jsx(_components.p,{children:`O recurso de ligações via API permite o envio de áudios pré-gravados como ligação no WhatsApp, possibilitando a automação de chamadas por meio de requisições HTTP simples, sem necessidade de bibliotecas adicionais.`}),`\n`,_jsx(_components.p,{children:`A documentação completa do endpoint está disponível em:`}),`\n`,_jsxs(_components.p,{children:[`🔗 `,_jsx(_components.a,{href:`https://developer.z-api.io/calls/send-call`,children:`https://developer.z-api.io/calls/send-call`})]}),`\n`,_jsx(Heading,{level:`2`,id:`2-via-sdk-software-development-kit`,children:`2. Via SDK (Software Development Kit)`}),`\n`,_jsx(_components.p,{children:`O SDK (Software Development Kit) é um conjunto de bibliotecas e métodos disponibilizados pelo Z-API para facilitar a integração nas suas aplicações. Em vez de montar manualmente as requisições HTTP, o SDK abstrai essa complexidade, oferecendo funções prontas e intuitivas para realizar ações como iniciar uma ligação, monitorar eventos e tratar erros.`}),`\n`,_jsxs(_components.p,{children:[`Para o recurso de ligações, o SDK vai além do envio de áudios pré-gravados — ele permite realizar `,_jsx(_components.strong,{children:`ligações de vídeo e ligações ao vivo`}),`, com suporte a até `,_jsx(_components.strong,{children:`3 chamadas simultâneas`}),`, tornando-o ideal para cenários de atendimento em tempo real e comunicação mais rica com o cliente.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Importante: para utilizar o recurso de ligações via SDK, é necessário\nprimeiramente solicitar o token de ligação e realizar a inicialização do SDK\nantes de efetuar qualquer chamada.`})}),`\n`,_jsx(_components.p,{children:`A documentação sobre como solicitar o token efêmero:`}),`\n`,_jsxs(_components.p,{children:[`🔗 `,_jsx(_components.a,{href:`https://developer.z-api.io/calls/call-token`,children:`https://developer.z-api.io/calls/call-token`})]}),`\n`,_jsx(Heading,{level:`3`,id:`após-gerar-o-token-siga-exemplo-de-inicialização-do-sdk`,children:`Após gerar o token, siga exemplo de inicialização do SDK:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`21`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light poimandres`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#1b1e28`,color:`#24292e`,\"--shiki-dark\":`#a6accd`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`21`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:`import { `}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:`init`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:` } from `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#5DE4C7`},children:`@z-api/call`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:`const client = init({`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` instanceId`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#5DE4C7`},children:`SUA_INSTANCE_ID`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` getToken`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:`: `}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:`async`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` ()`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` =>`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:` {`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-light-font-style\":`inherit`,\"--shiki-dark\":`#767C9DB0`,\"--shiki-dark-font-style\":`italic`},children:` // Chama SEU backend, que por sua vez chama a Z-API para obter o token efêmero`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` const`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` res`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` =`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` await`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` fetch(`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#ADD7FF`},children:`https://seu-backend.com/call-token`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` const`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` data`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` =`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` await`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` res.json();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` return`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` data.token;`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-light-font-style\":`inherit`,\"--shiki-dark\":`#767C9DB0`,\"--shiki-dark-font-style\":`italic`},children:`// Ouvir eventos`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:`client.on(`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#5DE4C7`},children:`call:incoming`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:`, (call) => {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` console.log(`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#E4F0FB`},children:`Chamada recebida de`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:`,`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` call.from);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:`client.on(`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#5DE4C7`},children:`connected`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:`, () => {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:` console.log(`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#E4F0FB`},children:`Conectado ao servidor`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#A6ACCD`},children:`\"`}),_jsx(_components.span,{style:{color:`#B31D28`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#D0679D`,\"--shiki-dark-font-style\":`inherit`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#A6ACCD`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Para mais comandos de SDK segue a documentação:`}),`\n`,_jsxs(_components.p,{children:[`🔗 `,_jsx(_components.a,{href:`https://www.npmjs.com/package/@z-api/call`,children:`https://www.npmjs.com/package/@z-api/call`})]}),`\n`,_jsx(Heading,{level:`2`,id:`3-via-sip-session-initiation-protocol`,children:`3. Via SIP (Session Initiation Protocol)`}),`\n`,_jsx(_components.p,{children:`O SIP (Session Initiation Protocol) é um protocolo de comunicação padrão da indústria de telefonia, utilizado para iniciar, manter e encerrar sessões de voz e vídeo via internet (VoIP).`}),`\n`,_jsx(_components.p,{children:`No contexto do Z-API, a integração via SIP permite que empresas que já possuem infraestrutura de telefonia como PABX IP, softphones ou provedores VoIP conectem essa estrutura ao WhatsApp, realizando ligações diretamente pela sua plataforma sem depender de um dispositivo físico.`}),`\n`,_jsx(Heading,{level:`3`,id:`exemplo-de-integração-com-a-plataforma-microsip`,children:`Exemplo de integração com a plataforma MicroSIP:`}),`\n`,_jsx(_components.p,{children:`O MicroSIP é um softphone gratuito compatível com o protocolo SIP, que pode ser utilizado para realizar ligações pelo WhatsApp através do Z-API.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Passo 1 — Obtendo as credenciais no painel Z-API:`})}),`\n`]}),`\n`,_jsx(_components.p,{children:`Acesse: Painel Z-API → Instância Web → Selecione a instância → Aba “Ligações” → Seção “Via SIP”`}),`\n`,_jsx(_components.p,{children:`Copie os três dados exibidos:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`HOST: sip.z-api.io`}),`\n`,_jsx(_components.li,{children:`USUÁRIO: É o instanceID onde você pode buscar no painel da instancia`}),`\n`,_jsx(_components.li,{children:`TOKEN: senha gerada — exibida apenas uma vez`}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Salve o TOKEN antes de sair da página, pois ele não será exibido novamente.\nCaso perca, clique em “Gerar nova senha” para criar um novo.`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Passo 2 — Configurando o MicroSIP:`})}),`\n`]}),`\n`,_jsx(_components.p,{children:`Após instalar o MicroSIP, acesse o menu principal → “Adicionar conta” e preencha os campos:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Campo`}),_jsx(_components.th,{children:`Valor`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Servidor SIP`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`sip.z-api.io`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Usuário`}),_jsx(_components.td,{children:`InstanceID`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Domínio`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`sip.z-api.io`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Login`}),_jsx(_components.td,{children:`InstanceID`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Senha`}),_jsx(_components.td,{children:`TOKEN copiado do painel`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Transporte`}),_jsx(_components.td,{children:`UDP`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Criptografia`}),_jsx(_components.td,{children:`Desabilitado`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Endereço Público`}),_jsx(_components.td,{children:`Auto`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Atualizar Registro`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`300`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Manter Ativo`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`15`})]})]})]}),`\n`,_jsx(`div`,{style:{display:`flex`,justifyContent:`center`},children:_jsx(OptimizedImage,{src:`https://mintcdn.com/z-api-8aa3bb40/GQnVR5xNzwNxN2H-/images/MicroSipIntegration.png?fit=max\u0026auto=format\u0026n=GQnVR5xNzwNxN2H-\u0026q=85\u0026s=09b121503a1107b500024f91c40fb05b`,width:`500`,height:`800`,\"data-og-width\":`616`,\"data-og-height\":`698`,\"data-path\":`images/MicroSipIntegration.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/z-api-8aa3bb40/GQnVR5xNzwNxN2H-/images/MicroSipIntegration.png?w=280\u0026fit=max\u0026auto=format\u0026n=GQnVR5xNzwNxN2H-\u0026q=85\u0026s=8df116396cdf474f393c2b926196e3ac 280w, https://mintcdn.com/z-api-8aa3bb40/GQnVR5xNzwNxN2H-/images/MicroSipIntegration.png?w=560\u0026fit=max\u0026auto=format\u0026n=GQnVR5xNzwNxN2H-\u0026q=85\u0026s=1ca92532fe819de607f6fe457960b076 560w, https://mintcdn.com/z-api-8aa3bb40/GQnVR5xNzwNxN2H-/images/MicroSipIntegration.png?w=840\u0026fit=max\u0026auto=format\u0026n=GQnVR5xNzwNxN2H-\u0026q=85\u0026s=ec311cfebfe4ccfcaeee1c39d3d543ae 840w, https://mintcdn.com/z-api-8aa3bb40/GQnVR5xNzwNxN2H-/images/MicroSipIntegration.png?w=1100\u0026fit=max\u0026auto=format\u0026n=GQnVR5xNzwNxN2H-\u0026q=85\u0026s=df0ea14ad6fbc5d3843e20bd08ba45bf 1100w, https://mintcdn.com/z-api-8aa3bb40/GQnVR5xNzwNxN2H-/images/MicroSipIntegration.png?w=1650\u0026fit=max\u0026auto=format\u0026n=GQnVR5xNzwNxN2H-\u0026q=85\u0026s=e6e058ae855652ac5e8223299d4ffbe9 1650w, https://mintcdn.com/z-api-8aa3bb40/GQnVR5xNzwNxN2H-/images/MicroSipIntegration.png?w=2500\u0026fit=max\u0026auto=format\u0026n=GQnVR5xNzwNxN2H-\u0026q=85\u0026s=2ff290c0767a6bbc27186da4a955c500 2500w`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Passo 3 — Verificando a conexão:`})}),`\n`]}),`\n`,_jsx(_components.p,{children:`Após salvar, o ícone do MicroSIP ficará verde, indicando que o registro foi realizado com sucesso e a integração está pronta para uso.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`considerações-finais`,children:`Considerações Finais`}),`\n`,_jsx(_components.p,{children:`O recurso de ligações do Z-API foi desenvolvido para atender diferentes perfis de integração, desde automações simples até operações mais complexas de telefonia. A escolha do método ideal depende das necessidades do seu projeto e da estrutura técnica disponível.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"poimandres"}},"config":{},"pageMetadata":{"title":"Ligações no Z-API Guia Completo","description":null,"href":"/tips/calls-guide"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Introdução","slug":"introdução","depth":2,"children":[]},{"title":"1. Via API","slug":"1-via-api","depth":2,"children":[]},{"title":"2. Via SDK (Software Development Kit)","slug":"2-via-sdk-software-development-kit","depth":2,"children":[{"title":"Após gerar o token, siga exemplo de inicialização do SDK:","slug":"após-gerar-o-token-siga-exemplo-de-inicialização-do-sdk","depth":3,"children":[]}]},{"title":"3. Via SIP (Session Initiation Protocol)","slug":"3-via-sip-session-initiation-protocol","depth":2,"children":[{"title":"Exemplo de integração com a plataforma MicroSIP:","slug":"exemplo-de-integração-com-a-plataforma-microsip","depth":3,"children":[]},{"title":"Considerações Finais","slug":"considerações-finais","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/z-api-8aa3bb40/a56ff8c5f47a412e/gptmaker.js"],"subdomain":"z-api-8aa3bb40","siteName":"Z-API Docs","title":"Ligações no Z-API Guia Completo - Z-API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/tips/calls-guide","matchLevel":0},"en":{"href":"/en/tips/calls-guide","matchLevel":1}}},"lastModified":"2026-10-06T17:36:04.234Z","originalFileLocation":"tips/calls-guide.mdx","locale":"pt-BR"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Z-API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/z-api-8aa3bb40/ZpLU815Jzg8ouylX/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/z-api-8aa3bb40/ZpLU815Jzg8ouylX/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/z-api-8aa3bb40/ZpLU815Jzg8ouylX/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/z-api-8aa3bb40/ZpLU815Jzg8ouylX/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/z-api-8aa3bb40/ZpLU815Jzg8ouylX/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/z-api-8aa3bb40/ZpLU815Jzg8ouylX/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/z-api-8aa3bb40/ZpLU815Jzg8ouylX/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/z-api-8aa3bb40/ZpLU815Jzg8ouylX/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/z-api-8aa3bb40/ZpLU815Jzg8ouylX/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Ligações no Z-API Guia Completo - Z-API Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Z-API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.z-api.io/tips/calls-guide\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://z-api-8aa3bb40.mintlify.app/_mintlify/api/og/v2?division=Dicas\u0026amp;title=Liga%C3%A7%C3%B5es+no+Z-API+Guia+Completo\u0026amp;theme=1e9f2e2415957578442f4649\u0026amp;signature=e5ce898aca92851b5068fa6490b82f81ac946ba666293f4ce0c7be36fafc70e5\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Ligações no Z-API Guia Completo - Z-API Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://z-api-8aa3bb40.mintlify.app/_mintlify/api/og/v2?division=Dicas\u0026amp;title=Liga%C3%A7%C3%B5es+no+Z-API+Guia+Completo\u0026amp;theme=1e9f2e2415957578442f4649\u0026amp;signature=e5ce898aca92851b5068fa6490b82f81ac946ba666293f4ce0c7be36fafc70e5\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/z-api-8aa3bb40/ZpLU815Jzg8ouylX/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Z-API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00B140\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.z-api.io/tips/calls-guide\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/tips/calls-guide.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://developer.z-api.io/tips/calls-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://developer.z-api.io/en/tips/calls-guide\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://developer.z-api.io/tips/calls-guide\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.z-api.io/#organization\",\"name\":\"Z-API Docs\",\"url\":\"https://developer.z-api.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://staging.z-api.io/logos/SVG/Ativo%2016.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.z-api.io#website\",\"name\":\"Z-API Docs\",\"url\":\"https://developer.z-api.io\",\"publisher\":{\"@id\":\"https://developer.z-api.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.z-api.io/tips/calls-guide#webpage\",\"url\":\"https://developer.z-api.io/tips/calls-guide\",\"name\":\"Ligações no Z-API Guia Completo\",\"dateModified\":\"2026-10-06T17:36:04.234Z\",\"isPartOf\":{\"@id\":\"https://developer.z-api.io#website\"},\"breadcrumb\":{\"@id\":\"https://developer.z-api.io/tips/calls-guide#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.z-api.io/tips/calls-guide#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Z-API Docs\",\"item\":\"https://developer.z-api.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Ligações no Z-API Guia Completo\",\"item\":\"https://developer.z-api.io/tips/calls-guide\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developer.z-api.io/tips/calls-guide#article\",\"headline\":\"Ligações no Z-API Guia Completo\",\"name\":\"Ligações no Z-API Guia Completo\",\"url\":\"https://developer.z-api.io/tips/calls-guide\",\"mainEntityOfPage\":{\"@id\":\"https://developer.z-api.io/tips/calls-guide#webpage\"},\"dateModified\":\"2026-10-06T17:36:04.234Z\",\"publisher\":{\"@id\":\"https://developer.z-api.io/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.z-api.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Z-API Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Z-API Docs","nav":{"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://www.z-api.io/blog"},{"anchor":"YouTube","icon":"youtube","href":"https://www.youtube.com/@z_api"},{"anchor":"Postman","icon":"rocket","href":"https://www.postman.com/docs-z-api/z-api-s-public-workspace/collection/gwri249/z-api-collection"},{"anchor":"WhatsApp","icon":"whatsapp","href":"https://chat.whatsapp.com/KmE3atZGmWJEspMZnBZKjV"}]},"languages":[{"language":"pt-BR","default":true,"navbar":{"links":[{"href":"https://api.whatsapp.com/send?phone=554431421722\u0026text=Ol%C3%A1,%20gostaria%20de%20falar%20com%20o%20suporte%20da%20Z-API","label":"Suporte"}],"primary":{"type":"button","label":"Painel","href":"https://app.z-api.io/"}},"tabs":[{"tab":"Documentação","groups":[{"group":"Início","pages":[{"title":"Introdução","href":"/quickstart/introduction"}]},{"group":"Segurança","pages":[{"title":"ID e Token","href":"/security/introduction"},{"title":"Restrição de chamadas por IP","href":"/security/ip-block"},{"title":"Autenticação de dois fatores","href":"/security/twofactor"},{"title":"Token de segurança da conta","href":"/security/client-token"},{"title":"Proteção Anti-Golpe em Grupos de Avisos","href":"/security/fraud-protection"}]},{"group":"MCP Server","pages":[{"title":"Introdução","href":"/mcp/introduction"},{"title":"Como conectar","description":"Conecte sua conta Z-API ao servidor MCP e autorize seu app de IA","href":"/mcp/how-to-connect"}]},{"group":"Dicas","pages":[{"title":"Ligações no Z-API Guia Completo","href":"/tips/calls-guide"},{"title":"Conexão via Extensão Z-API Conector","description":null,"href":"/tips/extension-guide"},{"title":"Bloqueios e Banimentos","href":"/tips/blockednumber"},{"title":"Bloqueios e Banimentos (2026)","href":"/tips/blockednumbernew"},{"title":"Guia de Boas Práticas para Uso do WhatsApp via API","href":"/tips/best-practices"},{"title":"Lid","href":"/tips/lid"},{"title":"Habilitando um número fixo","href":"/tips/enable-fix-number"},{"title":"Emuladores Android","href":"/tips/emulators"},{"title":"Z-API vs API Oficial","href":"/tips/Z-APIvsAPI-OFICIAL"},{"title":"Funcionamento dos Botões","href":"/tips/button-status"},{"title":"Prazo de expiração dos arquivos","href":"/tips/file-expiration"},{"title":"Coleção Postman","href":"/tips/postman-collection"}]},{"group":"Parceiros","pages":[{"title":"Conexão via extensão para parceiros","href":"/partner/extension-token"},{"title":"SDK de conexão","href":"/partner/sdk-connector"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},{"language":"en","navbar":{"links":[{"href":"https://api.whatsapp.com/send?phone=554431421722\u0026text=Hello,%20I%20would%20like%20to%20talk%20to%20Z-API%20support","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.z-api.io/"}},"pages":[{"title":"en","href":"/en/tips/calls-guide"}]}]},"title":"Ligações no Z-API Guia Completo - Z-API Docs","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-D7yRe3On.js","lightbox-handle-r17bVUz3.js"]}
