---
title: "Ligação pela API não oficial do WhatsApp: como o motor da WAME faz e atende chamadas"
description: "Como o motor da WAME faz, atende e toca áudio em ligações de WhatsApp pela API não oficial, a base para IA de voz e confirmação de agendamento, e a regra de uso que evita bloqueio."
url: "https://wame.api.br/blog/ligacao-api-nao-oficial-como-o-motor-funciona"
language: "pt-BR"
og:type: "article"
published_time: "2026-11-07"
modified_time: "2026-11-07"
author: "Raphael Serafim"
keywords: "motor wame, api não oficial whatsapp segura, ligação whatsapp api, ia de voz whatsapp, atender ligação whatsapp api"
reading_time: "7 min de leitura"
---

# Ligação pela API não oficial do WhatsApp: como o motor da WAME faz e atende chamadas

> Como o motor da WAME faz, atende e toca áudio em ligações de WhatsApp pela API não oficial, a base para IA de voz e confirmação de agendamento, e a regra de uso que evita bloqueio.

Ligação pela API é hoje um dos recursos mais pedidos da WAME: IA que atende o telefone, confirmação de agendamento por voz, retorno de atendimento sem ninguém discando. Este artigo mostra como o motor faz isso e a regra de uso que mantém o número tranquilo. Para o resumo do produto, veja a página da [API não oficial da WAME](/nao-oficial).

## Como o motor faz uma ligação

Uma ligação de WhatsApp tem duas partes: a **sinalização** (quem liga, quem atende, quando desliga) e a **mídia** (o áudio). O motor cuida das duas como um aparelho conectado do seu número:

1. envia a oferta de chamada ao WhatsApp do destinatário;
2. acompanha os sinais de toque, atendimento e recusa;
3. abre o canal de áudio cifrado quando a pessoa atende;
4. encaminha o áudio que você mandar para dentro da chamada;
5. avisa o seu sistema pelo webhook a cada mudança de estado.

Do seu lado, são poucas chamadas de API. A ligação precisa estar habilitada na instância.

## Ligar, tocar áudio, encerrar

Todos os exemplos usam a base `https://server.wame.api.br/SUA_KEY/`.

```bash
# Ligar
curl -X POST "https://server.wame.api.br/SUA_KEY/call" \
  -H "Content-Type: application/json" \
  -d '{ "to": "5566997145103" }'

# Tocar um áudio na chamada ativa
curl -X POST "https://server.wame.api.br/SUA_KEY/call/ID_DA_CHAMADA/audio" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://seu-site.com/confirmacao.mp3" }'

# Encerrar (callId e peerJid vêm na resposta do /call)
curl -X POST "https://server.wame.api.br/SUA_KEY/call/end" \
  -H "Content-Type: application/json" \
  -d '{ "callId": "ID_DA_CHAMADA", "peerJid": "5566997145103@s.whatsapp.net" }'
```

## Atender quem liga

Quando alguém liga para o seu número, o webhook recebe a chamada com o ID e quem está ligando. Para atender:

```bash
curl -X POST "https://server.wame.api.br/SUA_KEY/call/accept" \
  -H "Content-Type: application/json" \
  -d '{ "callId": "ID_DA_CHAMADA", "callFrom": "5566997145103@s.whatsapp.net" }'
```

Com a chamada atendida, o áudio pode vir de uma gravação ou de um agente de voz com IA. Os detalhes de montar o agente estão em [IA para atender ligação no WhatsApp](/blog/ia-atender-ligacao-whatsapp-api) e [agente de voz: latência e interrupção](/blog/agente-voz-whatsapp-latencia-interrupcao).

## O que dá para montar

- **IA que atende:** responde dúvidas por voz, agenda e transfere quando precisa;
- **confirmação de agendamento:** liga um dia antes e entende sim, não e remarcar, veja [IA que liga para confirmar agendamento](/blog/ia-ligar-confirmar-agendamento-whatsapp);
- **URA por voz:** um menu falado em vez de "digite 1", veja [URA inteligente no WhatsApp](/blog/ura-inteligente-whatsapp-ligacao);
- **recusar e responder por texto:** quando ninguém pode atender, veja [recusar ligação e responder por mensagem](/blog/recusar-ligacao-whatsapp-automatico-api).

## A regra que evita problema

Ligação segue a mesma lógica das mensagens:

- **atender quem liga** é uso normal;
- **ligar para quem já é seu contato** é uso normal: a confirmação que o cliente espera, o retorno que ele pediu;
- **ligação fria em volume**, para uma lista de quem nunca falou com você, é o que bane.

Uma regra prática: se a pessoa estranharia receber a ligação, não ligue pela API.

## Conclusão

O motor da WAME faz, atende, toca áudio e encerra ligações de WhatsApp como um aparelho conectado do seu número, e manda cada passo para o seu webhook. É a base para IA de voz, confirmação de agendamento e URA. Usada para quem liga e para quem já é seu contato, a ligação vira um canal novo de atendimento. Veja a página da [API não oficial](/nao-oficial).

## Perguntas frequentes

### Dá para fazer e atender ligação de WhatsApp pela API não oficial?

Sim. Com a permissão de chamadas habilitada na instância, a API faz ligações, atende chamadas recebidas, toca áudio durante a chamada e encerra. É a base para IA que atende e para confirmação de agendamento por voz.

### Ligação pela API dá bloqueio?

Atender quem liga e ligar para quem já é seu contato é uso normal. Ligação fria em volume, para quem nunca falou com você, é o que bane, do mesmo jeito que acontece com mensagem.

### Qual a diferença para a Calling API oficial?

A Calling API oficial é um recurso da Cloud API da Meta, com regras próprias. Na não oficial, a instância liga como aparelho conectado do seu número, no plano fixo da WAME.
