# Hasos

> Hasos é uma plataforma brasileira para fazer e receber ligações de voz pelo WhatsApp — direto do navegador, dentro do CRM ou no seu produto via API. Usa o número de WhatsApp que a empresa já tem (sem chip novo, sem DID, sem custo por minuto), então o cliente vê o nome da empresa e atende.

Preço fixo por faixa: Individual R$ 199,90/mês (até 3 números) e Time R$ 449,70/mês (até 10 números); acima de 10, sob consulta. 7 dias grátis. Site: https://hasos.com.br · API: https://api.hasos.com.br · MCP: https://api.hasos.com.br/mcp

---

<!-- https://hasos.com.br/produto.md -->

# Hasos — Produto

Canal complementar de voz no WhatsApp. Faça e receba chamadas pelo seu próprio número de WhatsApp, direto do navegador, e embarque isso no seu produto via API. Como as pessoas atendem WhatsApp identificado muito mais que número desconhecido, a taxa de atendimento sobe.

Site: https://hasos.com.br · API: https://api.hasos.com.br

## O que dá pra fazer
- **Ligar e atender no navegador** — discador web para chamadas de saída e para **atender** as chamadas que chegam no seu número.
- **Atendente de IA por voz** — conecte seu agente do ElevenLabs (BYOK); a IA atende e conversa com quem liga, inclusive fora do horário. (Faz parte do Pacote IA.)
- **Transcrição + resumo por IA** — cada chamada gravada vira transcrição completa + resumo em português com próximos passos, no painel e no webhook. (Pacote IA.)
- **Ligação em massa** — envie uma lista; a Hasos disca um a um e o primeiro que atender cai no seu discador.
- **Gravação estéreo** — cada chamada gravada (você de um lado, contato do outro) para ouvir e baixar.
- **Horário de atendimento + voicemail** — fora do horário, quem liga ouve sua saudação e deixa recado.
- **Integração com CRM** — RD Station, Pipedrive e HubSpot: cada chamada vira atividade no contato, com status, duração e link da gravação.

## Para desenvolvedores
- **API REST `/v1`** — provisione números (`POST /v1/instances`), emita tokens, gerencie chamadas e webhooks. Autenticação por header `x-api-key`.
- **Discador embarcável** — `<iframe src="https://phone.hasos.com.br?token=…" allow="microphone">` coloca o discador dentro do seu app/CRM.
- **Servidor MCP** — conecte Claude, Cursor ou seu agente de IA em `https://api.hasos.com.br/mcp` com a sua chave de API e opere a conta em linguagem natural (dispositivos, QR, chamadas, gravações, transcrições, leads). Detalhes: https://hasos.com.br/mcp.md
- **Acesso SIP** — use o número de WhatsApp num softphone (Zoiper, Linphone) ou PABX (Asterisk, Issabel, 3CX), host `sip.hasos.com.br`.
- **Webhooks assinados** — HMAC SHA-256 no header `x-webhook-signature`. Eventos: `CALL` (ringing/answered/ended), `RECORD` (gravação pronta), `TRANSCRIPT` (transcrição+resumo prontos), `DEVICE`. Um webhook por número ou um webhook global para todos.

## Confiabilidade / anti-bloqueio
- Ritmo de discagem anti-rajada por número (evita o padrão de robô que gera bloqueio).
- Painel de saúde do número + guia de aquecimento.
- Sessão do WhatsApp durável (sobrevive a reinícios/deploys).

## Preços (resumo)
- Individual: R$ 199,90/mês — até 3 números, chamadas ilimitadas.
- Time: R$ 449,70/mês — até 10 números, ligação em massa, relatório por vendedor, SIP.
- Operação: sob consulta — mais de 10 números, SLA.
- Pacote IA (add-on): +R$ 49,90 por número/mês (transcrição + resumo + webhook + atendente de IA; 1.000 min/número/mês).
- Todos começam com 7 dias grátis. Anual: 12 meses pelo preço de 10.
Detalhes: https://hasos.com.br/precos.md

---

<!-- https://hasos.com.br/precos.md -->

# Hasos — Preços

Preço fixo por faixa de números de WhatsApp. As chamadas trafegam por dados (WhatsApp), **sem custo por minuto** de telefonia e **sem taxa por conversa**. Todo plano começa com **7 dias grátis**. Site: https://hasos.com.br

## Planos

### Individual — R$ 199,90/mês
- **Até 3 números** de WhatsApp → até 3 ligações ao mesmo tempo
- Chamadas **ilimitadas**, sem tarifa por minuto
- Discador no navegador com número identificado (fazer e **receber** chamadas)
- Gravação estéreo e métricas
- Webhooks e API REST

### Time — R$ 449,70/mês (mais popular)
- **Até 10 números** de WhatsApp → até 10 ligações ao mesmo tempo
- Tudo do Individual
- Ligação em massa (a Hasos disca a lista; o primeiro que atender cai no seu discador)
- Relatório por vendedor
- Acesso SIP (softphone/PABX) e API

### Operação — sob consulta
- **Mais de 10 números**, orçamento sob medida
- Tudo do Time, sem limite de volume
- Pacote IA opcional em todos os números
- SLA e suporte dedicado
- Contato: vendas@hasos.com.br

## Add-ons
- **Pacote IA:** +R$ 49,90 por número/mês — transcrição automática + resumo em português de cada gravação (também no webhook `TRANSCRIPT`) e atendente de IA por voz (ElevenLabs, BYOK). Inclui 1.000 minutos de transcrição por número/mês.
- **Número avulso:** R$ 79,90 por número/mês — soma 1 número extra sem subir de faixa (até 5 avulsos). Para vários números, subir de plano sai mais barato.

## Cobrança anual
- 12 meses pelo preço de 10 (2 meses grátis).

## Observações
- Teste grátis de 7 dias em qualquer plano; cancele quando quiser antes do fim do teste.
- Cobrança recorrente via Stripe (cartão).
- Cada número de WhatsApp faz 1 chamada por vez (limite do próprio WhatsApp); para falar em paralelo, conecte mais números.
- Não há plano gratuito permanente para contas novas.

## Exemplos
- 1 a 3 vendedores (1 número cada) → Individual, R$ 199,90/mês.
- 5 vendedores → Time, R$ 449,70/mês.
- 4 vendedores → Individual + 1 número avulso (R$ 279,80/mês) ou Time (R$ 449,70/mês).
- 20 vendedores → Operação (sob consulta).

---

<!-- https://hasos.com.br/api.md -->

# Hasos — API de chamadas de voz no WhatsApp

API REST para fazer e receber **ligações de voz pelo WhatsApp** a partir do seu produto: conecte um número de WhatsApp existente (QR Code ou código de pareamento), emita tokens para o discador, receba eventos por webhook e baixe gravações e transcrições. Sem chip novo, sem DID, sem custo por minuto.

- Base URL: `https://api.hasos.com.br`
- Autenticação: header `x-api-key: hs_live_…` (crie a chave no painel em Configurações → Chaves de API)
- Formato: JSON
- Servidor MCP para agentes de IA: `https://api.hasos.com.br/mcp` (ver https://hasos.com.br/mcp.md)
- Guia completo (HTML): https://hasos.com.br/guides

## Conceitos
- **Dispositivo / instância**: um número de WhatsApp conectado à Hasos. Cada número faz 1 chamada por vez (limite do WhatsApp); N números = N chamadas simultâneas.
- **Token de dispositivo**: credencial do discador (iframe/embed) para um número, sem expor a chave de API.
- **Webhook**: URL que recebe eventos assinados (HMAC SHA-256).

## Endpoints principais

| Método | Caminho | Descrição |
|---|---|---|
| POST | `/v1/instances` | Cria um dispositivo (número). Body opcional: `{ "phone": "5511999999999" }` |
| GET | `/v1/instances` | Lista os dispositivos da conta |
| GET | `/v1/instances/:id` | Detalhes e status do dispositivo |
| DELETE | `/v1/instances/:id` | Remove o dispositivo |
| GET | `/v1/instances/:id/qr` | QR Code (string) + `status` + `error` para vincular o WhatsApp |
| GET | `/v1/instances/:id/pairing-code` | Código de 8 caracteres para vincular sem QR |
| POST | `/v1/instances/:id/import-session` | Importa uma sessão Baileys existente (Evolution, WAHA-NOWEB) sem QR |
| POST | `/v1/instances/:id/restart` | Reinicia a conexão com o WhatsApp |
| POST | `/v1/instances/:id/tokens` | Emite um token do discador |
| POST | `/v1/instances/:id/webhook` | Define a URL do webhook do número (retorna o secret) |
| GET | `/v1/instances/:id/webhook/deliveries` | Entregas recentes do webhook |
| GET/PUT/DELETE | `/v1/webhook` | Webhook global da conta (todos os números) |
| POST | `/v1/webhook/test` | Envia um evento de teste |
| GET | `/v1/instances/:id/sip` | Credenciais SIP do número |
| POST | `/v1/instances/:id/sip/enable` | Liga/desliga o SIP (`{ "enabled": true }`, plano pago) |
| POST | `/v1/instances/:id/sip/regenerate` | Gera nova senha SIP |
| GET | `/v1/calls` | Histórico de chamadas da conta |
| GET | `/v1/live-calls` | Chamadas em andamento |
| GET | `/v1/calls/:id/recording` | Link assinado da gravação |
| GET | `/v1/recordings/:id/transcript` | Transcrição + resumo por IA (Pacote IA) |
| GET | `/v1/analytics` | Métricas agregadas (taxa de atendimento, volume…) |
| GET | `/v1/leads` · POST `/v1/leads/bulk` · POST `/v1/leads/status` | Leads do funil |
| GET | `/v1/api-keys` | Lista chaves (mascaradas) |

## Conectar um número (QR Code)
```js
const KEY = "hs_live_sua_chave";
const { id } = await fetch("https://api.hasos.com.br/v1/instances", {
  method: "POST", headers: { "x-api-key": KEY, "Content-Type": "application/json" }, body: "{}",
}).then((r) => r.json());

// Faça polling de /qr a cada 2–3 s e re-renderize o QR (ele muda a cada ~20 s).
const poll = setInterval(async () => {
  const { qr, status, error } = await fetch(`https://api.hasos.com.br/v1/instances/${id}/qr`, {
    headers: { "x-api-key": KEY },
  }).then((r) => r.json());
  if (status === "CONNECTED") { clearInterval(poll); return; }
  if (qr) renderizarQR(qr); // desenhe a string como QR
}, 2500);
```
No celular: WhatsApp → Configurações → Aparelhos conectados → Conectar aparelho. Alternativa sem câmera: `GET /v1/instances/:id/pairing-code` e "Conectar com número de telefone".

## Fazer e receber chamadas
As chamadas são feitas pelo **discador** (WebRTC no navegador), autenticado por token de dispositivo:
- **Iframe:** `<iframe src="https://phone.hasos.com.br/?token=TOKEN" allow="microphone">`
- **Headless (sua UI):**
```html
<script src="https://phone.hasos.com.br/embed.js"></script>
<script>
  const phone = HasosPhone.create({ token: "TOKEN", allowedOrigin: "https://seu-app.com" });
  await phone.ready();
  phone.call.start("5511999998888");          // ligar
  phone.on("offer:received", () => phone.call.accept()); // atender
  phone.on("call:ended", (c) => console.log(c));
</script>
```
- **SIP:** registre um softphone ou PABX em `sip.hasos.com.br` com as credenciais de `/v1/instances/:id/sip`.

## Webhooks
Cada entrega traz `x-webhook-signature: sha256=<HMAC>` — HMAC SHA-256 do corpo bruto com o secret.

```json
{
  "event": "CALL",
  "instanceId": "a1b2c3d4",
  "phone": "5511988887777",
  "timestamp": "2026-07-01T13:14:41.077Z",
  "data": {
    "type": "ended",
    "callId": "00ED0D44…",
    "direction": "OUTGOING",
    "peerPhone": "5511999999999",
    "durationSec": 23,
    "endReason": "user_ended"
  }
}
```
Eventos: `CALL` (`ringing` | `answered` | `ended`), `RECORD` (gravação pronta, com URL assinada por 7 dias), `TRANSCRIPT` (transcrição + resumo), `DEVICE` (status do número).

### Valores de `endReason` (evento CALL `ended`)
| Valor | Significado |
|---|---|
| `user_ended` | Desligada normalmente por um dos lados |
| `declined` | Recusada |
| `busy` | Ocupado |
| `timeout` | Ninguém atendeu, ou encerrada por tempo pela plataforma |
| `cancelled` | Quem ligou cancelou antes de atenderem |
| `failed` | Falha técnica (conexão ou áudio) |
| `do_not_disturb` | Contato em modo não perturbe |
| `after_hours` | Recebida fora do horário de atendimento, recusada automaticamente |
| `unknown` | Não identificado |

Para saber se foi atendida use `durationSec > 0`. Trate valores fora da lista como `unknown`.

## Erros comuns
| HTTP | `error` | Quando |
|---|---|---|
| 401 | `Unauthorized` | Chave ausente ou inválida |
| 402 | `TRIAL_REQUIRED` | Conta nova sem teste/assinatura ativa tentando criar número |
| 402 | `DEVICE_LIMIT` | Limite de números do plano atingido |
| 402 | `ACCOUNT_SUSPENDED` | Pagamento em atraso |
| 403 | `plan_required` | Recurso de plano pago (ex.: SIP) |

As respostas de erro trazem `message` em português.

---

<!-- https://hasos.com.br/mcp.md -->

# Hasos — Servidor MCP (agentes de IA)

A Hasos tem um **servidor MCP remoto** para que agentes de IA (Claude, Cursor, ChatGPT e qualquer cliente compatível com Model Context Protocol) operem uma conta Hasos em linguagem natural: conectar números de WhatsApp, gerar QR Code, consultar chamadas, gravações, transcrições, métricas, webhook e leads.

- URL: `https://api.hasos.com.br/mcp`
- Transporte: Streamable HTTP (stateless, JSON-RPC 2.0)
- Autenticação: `x-api-key: hs_live_…` ou `Authorization: Bearer hs_live_…`
- Nada para instalar. O agente tem as mesmas permissões e limites da chave usada.

## Configuração

**Claude Code**
```bash
claude mcp add --transport http hasos https://api.hasos.com.br/mcp --header "x-api-key: hs_live_sua_chave"
```

**Cursor** (`~/.cursor/mcp.json`) e outros clientes com MCP remoto
```json
{ "mcpServers": { "hasos": { "url": "https://api.hasos.com.br/mcp", "headers": { "x-api-key": "hs_live_sua_chave" } } } }
```

**Claude Desktop** (via ponte `mcp-remote`)
```json
{ "mcpServers": { "hasos": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.hasos.com.br/mcp", "--header", "Authorization: Bearer hs_live_sua_chave"] } } }
```

## Ferramentas
| Ferramenta | O que faz |
|---|---|
| `list_devices`, `get_device` | Números conectados e status |
| `create_device` | Cria um dispositivo para conectar um WhatsApp |
| `get_device_qr`, `get_pairing_code` | QR Code ou código de pareamento |
| `restart_device`, `delete_device` | Reinicia ou remove um dispositivo |
| `list_live_calls` | Chamadas em andamento |
| `list_calls` | Histórico de chamadas (filtro por dispositivo, limite) |
| `get_call_recording`, `get_call_transcript` | Gravação e transcrição + resumo por IA |
| `get_analytics` | Taxa de atendimento, volume, duração média |
| `get_webhook`, `set_webhook`, `test_webhook` | Webhook da conta |
| `list_leads`, `add_leads`, `set_lead_status` | Leads do funil |

## Exemplos de pedidos
- "Cria um dispositivo e me mostra o QR para conectar meu WhatsApp."
- "Quantas ligações foram atendidas essa semana?"
- "Qual o resumo da última ligação com o Rafael?"
- "Adiciona esses 30 leads no funil e configura o webhook para https://meu-app.com/hasos."

Iniciar uma ligação ainda não é uma ferramenta MCP: as chamadas saem pelo discador (navegador, iframe/embed) ou por SIP.

---

<!-- https://hasos.com.br/faq.md -->

# Hasos — Perguntas frequentes

## O que é a Hasos?
Uma plataforma brasileira para fazer e receber **ligações de voz pelo WhatsApp** a partir do navegador, do seu CRM ou do seu produto (API). Você usa o número de WhatsApp que a empresa já tem; o cliente vê o nome da empresa e atende mais do que atenderia um número desconhecido. Site: https://hasos.com.br

## Preciso de chip, número novo ou operadora?
Não. Você conecta um número de WhatsApp existente por QR Code ou código de pareamento. Não precisa de chip novo, DID nem contrato com operadora.

## Quanto custa?
Faixas fixas, sem tarifa por minuto: **Individual R$ 199,90/mês** (até 3 números) e **Time R$ 449,70/mês** (até 10 números). Acima de 10 números, sob consulta. Pacote IA opcional: +R$ 49,90 por número/mês. Número avulso: R$ 79,90/mês. Todo plano começa com **7 dias grátis**. Detalhes: https://hasos.com.br/precos.md

## Tem plano gratuito?
Não há plano gratuito permanente para contas novas; há um **teste grátis de 7 dias**.

## Quantas ligações posso fazer ao mesmo tempo?
O WhatsApp permite 1 chamada por vez por número. Para falar em paralelo, conecte mais números: 3 números = 3 ligações simultâneas.

## Tem limite de chamadas ou minutos?
Nos planos pagos as chamadas são ilimitadas, sem custo por minuto.

## Consigo receber (atender) ligações, não só fazer?
Sim. O discador toca quando alguém liga para o seu WhatsApp, e você atende no navegador. Também dá para rotear para um atendente de IA, para um softphone/PABX via SIP, ou para caixa de recado fora do horário.

## As ligações são gravadas?
Sim, em estéreo (você de um lado, contato do outro), para ouvir e baixar no painel ou por API/webhook. Com o Pacote IA, cada gravação vira transcrição completa + resumo em português com próximos passos.

## Tem atendente de IA por voz?
Sim. Com o Pacote IA você conecta um agente do ElevenLabs (com a sua própria chave) e a IA atende e conversa com quem liga, inclusive fora do horário.

## Integra com CRM?
Sim: RD Station, Pipedrive e HubSpot (cada chamada vira atividade no contato, com status, duração e link da gravação). Para outros sistemas, use a API REST, os webhooks ou o discador em iframe.

## Tem API para desenvolvedores?
Sim. API REST em `https://api.hasos.com.br/v1` (autenticação `x-api-key`), webhooks assinados com HMAC SHA-256, discador embarcável (iframe ou headless) e acesso SIP. Referência: https://hasos.com.br/api.md

## Funciona com agentes de IA (Claude, Cursor, ChatGPT)?
Sim. Há um servidor MCP em `https://api.hasos.com.br/mcp`: conecte com a sua chave de API e o agente gerencia números, QR, chamadas, gravações, transcrições e leads. Detalhes: https://hasos.com.br/mcp.md

## Funciona com meu PABX ou softphone?
Sim, nos planos pagos: registre Zoiper, Linphone, Asterisk, Issabel ou 3CX em `sip.hasos.com.br` e use o número de WhatsApp por SIP, com a mesma gravação e webhooks.

## Corro risco de ter o número bloqueado?
Como em qualquer uso do WhatsApp, existe risco se o número for novo ou usado de forma abusiva. A Hasos respeita os limites do app (1 chamada por número por vez, ritmo anti-rajada na discagem em massa) e oferece painel de saúde do número e guia de aquecimento. Recomendação: comece com um número já aquecido. Boas práticas: https://hasos.com.br/guides/boas-praticas

## Onde ficam os dados?
Gravações e dados ficam armazenados no Brasil, isolados por conta. A sessão do WhatsApp é durável: sobrevive a reinícios e deploys sem precisar parear de novo.

## A Hasos é a API oficial de chamadas da Meta (WhatsApp Business Calling API)?
Não. A Hasos conecta o seu número de WhatsApp existente por QR Code (como um aparelho conectado), sem taxa por conversa da Business Platform. Comparativo com outras opções: https://hasos.com.br/blog/api-de-chamadas-whatsapp-hasos-vs-twilio-meta-voximplant

## Como começo?
Crie a conta em https://hasos.com.br/signup (e-mail corporativo), ative o teste de 7 dias, conecte o número pelo QR Code e ligue pelo discador.

---

<!-- https://hasos.com.br/casos-de-uso.md -->

# Hasos — Casos de uso

A Hasos serve para qualquer time que precisa **falar por voz** com clientes que não atendem número desconhecido, mas atendem o WhatsApp. Páginas completas em https://hasos.com.br/produto.

## Por segmento
- **Imobiliárias** — corretores ligam para o lead do imóvel pelo WhatsApp que o cliente reconhece e atende. Gravação, ligação em massa e registro no CRM. https://hasos.com.br/produto/para/imobiliaria
- **Clínicas** — confirmar e remarcar consultas ligando pelo WhatsApp que o paciente já conhece. Menos faltas, gravação e atendente de IA. https://hasos.com.br/produto/para/clinica
- **Cobrança** — negociar por voz pelo WhatsApp, com ligação em massa da carteira, gravação de cada acordo e registro no CRM. https://hasos.com.br/produto/para/cobranca
- **E-commerce** — recuperar carrinho, confirmar pedido e resolver entrega por voz. Ligação em massa e API. https://hasos.com.br/produto/para/e-commerce
- **Advocacia** — atender e retornar clientes por voz, com gravação e horário de atendimento. https://hasos.com.br/produto/para/advocacia
- **Agências e desenvolvedores** — embarcar chamadas de WhatsApp nos projetos entregues, via discador iframe, API REST e webhooks. https://hasos.com.br/produto/para/agencia

## Por função
- **SDR / pré-vendas e inside sales** — discador no navegador + ligação em massa: a Hasos disca a lista e o primeiro que atender cai no discador.
- **Gestor comercial** — relatório por vendedor, taxa de atendimento e gravações para coaching.
- **Atendimento / suporte** — atender no navegador, atendente de IA 24h e recado fora do horário.
- **Call center com PABX** — usar o WhatsApp como tronco SIP (Asterisk, Issabel, 3CX).
- **Produto SaaS / CRM** — oferecer chamadas de WhatsApp aos seus clientes via API, iframe ou discador headless (revenda disponível: https://hasos.com.br/revenda).
- **Agentes de IA** — um agente (Hermes, OpenClaw ou o seu) faz e recebe ligações de voz por WhatsApp; operação da conta via servidor MCP. https://hasos.com.br/produto/whatsapp-para-agentes-de-ia

## Por que WhatsApp e não telefone
- O cliente vê o nome/foto da empresa em vez de um número desconhecido.
- Sem custo por minuto de telefonia: preço fixo por faixa de números.
- Sem chip novo nem DID: usa o número que a empresa já tem.