---
title: "REST API — WAME API Documentação"
description: "Documentação completa da REST API para integração com a WAME API. Exemplos com cURL para todos os endpoints: mensagens, grupos, webhooks, newsletter e mais."
url: "https://api-wa.me/docs/api"
language: "pt-BR"
og:type: "website"
og:site_name: "WAME API"
---

REST API

# REST API (cURL)

Documentação completa da REST API com exemplos cURL para todos os endpoints. Use com qualquer linguagem que suporte HTTP.

[Swagger / OpenAPI](https://us.api-wa.me/docs/)[Postman](https://documenter.getpostman.com/view/27660901/2sA3Qs9s7K)

## Base URL e Autenticação

A API usa a chave da instância (`key`) diretamente na URL. Não é necessário header de autenticação.

Produção: https://us.api-wa.me

Produção: https://server.api-wa.me

Dev: http://0.0.0.0:3002

Formato da URL: `https://us.api-wa.me/{key}/{resource}`

curl

copiar

```
# Formato base de todas as requisições
curl -X GET "https://us.api-wa.me/{KEY}/instance"

# Com body JSON
curl -X POST "https://us.api-wa.me/{KEY}/message/text" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "text": "Hello!"}'
```

## Instância

Gerencie conexão, configurações e perfil da instância.

GET`/{key}/instance`— Informações da instância

curl

copiar

```
curl "https://us.api-wa.me/YOUR_KEY/instance"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "instance": {
    "receive_status_message": false,
    "save_media": false,
    "receive_presence": false,
    "permission": 1,
    "mark_messages": true,
    "blocked": false,
    "user": {
      "id": "[email protected]",
      "lid": "123456789@lid",
      "name": "My Bot",
      "imageProfile": "https://pps.whatsapp.net/..."
    },
    "phoneConnected": true,
    "webhook": {
      "allowWebhook": true,
      "allowNumber": "all",
      "webhookMessage": "https://your-webhook.com/message",
      "webhookGroup": "",
      "webhookConnection": "",
      "webhookQrCode": "",
      "webhookMessageFromMe": "",
      "webhookHistory": ""
    },
    "businessProfile": {
      "wid": "[email protected]",
      "description": "WhatsApp Bot",
      "website": [
        "https://api-wa.me"
      ],
      "category": "Technology"
    }
  }
}
```

POST`/{key}/instance`— Conectar via QR Code

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/instance"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "phoneConnected": false,
  "qrcode": "[email protected]...",
  "image": "data:image/png;base64,iVBORw0KGgo...",
  "user": null
}
```

POST`/{key}/instance/pairing-code`— Conectar via Pairing Code

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/instance/pairing-code" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber": "559999999999"}'
```

200 OKresponse

copiar

```
{
  "status": 200,
  "code": "A1B2-C3D4"
}
```

PATCH`/{key}/instance`— Atualizar configurações

curl

copiar

```
curl -X PATCH "https://us.api-wa.me/YOUR_KEY/instance?markMessageRead=true&saveMedia=false&receiveStatusMessage=false&receivePresence=false"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "message": "Settings updated"
}
```

DELETE`/{key}/instance`— Logout

curl

copiar

```
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/instance"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "message": "Logged out"
}
```

POST`/{key}/instance/restart`— Restart

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/instance/restart"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "message": "Restarted"
}
```

POST`/{key}/instance/resync`— Resync completo

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/instance/resync"
```

#### Perfil

curl

copiar

```
# Atualizar nome
curl -X PUT "https://us.api-wa.me/YOUR_KEY/instance/profile/name" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Bot"}'

# Atualizar status
curl -X PUT "https://us.api-wa.me/YOUR_KEY/instance/status" \
  -H "Content-Type: application/json" \
  -d '{"text": "Online 🟢"}'

# Atualizar foto de perfil
curl -X PUT "https://us.api-wa.me/YOUR_KEY/instance/profile/picture" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/avatar.jpg"}'

# Remover foto de perfil
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/instance/profile/picture"
```

#### Proxy e MongoDB

curl

copiar

```
# Configurar proxy
curl -X POST "https://us.api-wa.me/YOUR_KEY/instance/proxy" \
  -H "Content-Type: application/json" \
  -d '{"proxy": "http://user:pass@ip:port"}'

# Configurar MongoDB
curl -X POST "https://us.api-wa.me/YOUR_KEY/instance/mongodb" \
  -H "Content-Type: application/json" \
  -d '{"uri": "mongodb+srv://...", "dbName": "mydb"}'
```

#### Conexão Mobile

curl

copiar

```
# Passo 1: Preparar
curl -X POST "https://us.api-wa.me/YOUR_KEY/instance/mobile/prepare" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumberCountryCode": "55", "phoneNumberNationalNumber": "11999999999", "phoneNumberMobileNetworkCode": "11"}'

# Passo 2: Solicitar código
curl -X POST "https://us.api-wa.me/YOUR_KEY/instance/mobile/request-code" \
  -H "Content-Type: application/json" \
  -d '{"method": "sms"}'

# Passo 3: Verificar código
curl -X POST "https://us.api-wa.me/YOUR_KEY/instance/mobile/verify" \
  -H "Content-Type: application/json" \
  -d '{"code": "123456"}'
```

## Webhooks

PUT`/{key}/instance`— Configurar webhooks

curl

copiar

```
curl -X PUT "https://us.api-wa.me/YOUR_KEY/instance" \
  -H "Content-Type: application/json" \
  -d '{
    "allowWebhook": true,
    "allowNumber": "all",
    "webhookMessage": "https://your-webhook.com/message",
    "webhookGroup": "",
    "webhookConnection": "",
    "webhookQrCode": "",
    "webhookMessageFromMe": "",
    "webhookHistory": ""
  }'
```

GET`/{key}/instance/webhook/statistics`— Estatísticas

curl

copiar

```
curl "https://us.api-wa.me/YOUR_KEY/instance/webhook/statistics"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": {
    "totalSent": 1250,
    "totalFailed": 3,
    "totalPending": 0,
    "avgResponseTime": 142
  }
}
```

## Enviar Texto

POST`/{key}/message/text`

O campo opcional `provider` (`whatsapp` padrão, `instagram`, `messenger`) seleciona o canal oficial no mesmo endpoint — mesmo corpo, só muda o `provider`.

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/text" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "text": "Hello!", "provider": "whatsapp"}'
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": {
    "key": {
      "remoteJid": "[email protected]",
      "fromMe": true,
      "id": "3EB0A0B1C2D3E4F5A6B7C8"
    },
    "message": {
      "extendedTextMessage": {
        "text": "Hello!"
      }
    },
    "messageTimestamp": "1718900000",
    "status": "PENDING"
  }
}
```

## Enviar Mídia

POST`/{key}/message/image`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/image" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "url": "https://example.com/photo.jpg", "caption": "Toronto", "provider": "whatsapp"}'
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": {
    "key": {
      "remoteJid": "[email protected]",
      "fromMe": true,
      "id": "3EB0B1C2D3E4F5A6B7C8D9"
    },
    "message": {
      "imageMessage": {
        "url": "...",
        "caption": "Toronto"
      }
    },
    "messageTimestamp": "1718900000",
    "status": "PENDING"
  }
}
```

POST`/{key}/message/audio`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/audio" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "url": "https://example.com/audio.mp3", "provider": "whatsapp"}'
```

POST`/{key}/message/video`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/video" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "url": "https://example.com/video.mp4", "caption": "Big Buck Bunny", "provider": "whatsapp"}'
```

POST`/{key}/message/document`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/document" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "url": "https://example.com/file.pdf", "mimetype": "application/pdf", "fileName": "Resume.pdf", "provider": "whatsapp"}'
```

POST`/{key}/message/sticker`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/sticker" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "url": "https://example.com/sticker.webp"}'
```

POST`/{key}/message/video-note`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/video-note" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "url": "https://example.com/video.mp4"}'
```

#### Envio via Base64

curl

copiar

```
# Imagem Base64
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/base64/image" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "base64": "data:image/png;base64,...", "caption": "Caption"}'

# Áudio Base64
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/base64/audio" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "base64": "data:audio/mp3;base64,..."}'

# Documento Base64
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/base64/document" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "base64": "data:application/pdf;base64,...", "mimetype": "application/pdf", "fileName": "file.pdf"}'
```

## Enviar Contato

POST`/{key}/message/contact`— Contato único

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/contact" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "559999999999",
    "contact": {"fullName": "Raphael", "phoneNumber": "559999999999", "organization": "api-wa.me"}
  }'
```

POST`/{key}/message/contacts`— Múltiplos contatos

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/contacts" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "559999999999",
    "displayName": "Meus Contatos",
    "contacts": [
      {"fullName": "Raphael", "phoneNumber": "559999999999"},
      {"fullName": "João", "phoneNumber": "559888888888", "organization": "WAME"}
    ]
  }'
```

## Enviar Localização

POST`/{key}/message/location`— Localização fixa

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/location" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "559999999999",
    "location": {"latitude": 37.7749, "longitude": -122.4194, "address": "San Francisco, CA"}
  }'
```

POST`/{key}/message/live-location`— Tempo real

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/live-location" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "latitude": -23.5505, "longitude": -46.6333, "caption": "Estou aqui!"}'
```

## Link Preview

POST`/{key}/message/link`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/link" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "559999999999",
    "title": "API WhatsApp",
    "text": "Check out our API",
    "description": "Powerful WhatsApp integration",
    "thumbnailUrl": "https://example.com/thumb.jpg",
    "sourceUrl": "https://api-wa.me"
  }'
```

## Reação e Presença

POST`/{key}/message/reaction`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/reaction" \
  -H "Content-Type: application/json" \
  -d '{"text": "👍", "msgId": "MESSAGE_ID"}'
```

POST`/{key}/message/presence`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/presence" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "status": "composing"}'
# status: unavailable, available, composing, recording, paused
```

## Mensagem com Título

POST`/{key}/message/title`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/title" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "title": "Order #123", "text": "Your order is ready", "footer": "Thank you!"}'
```

## Botões

POST`/{key}/message/button_reply`— Botões de resposta

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/button_reply" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "559999999999",
    "header": {"title": "Choose an option"},
    "text": "What do you prefer?",
    "footer": "Select one",
    "buttons": [
      {"type": "quick_reply", "id": "1", "text": "Yes"},
      {"type": "quick_reply", "id": "2", "text": "No"}
    ]
  }'
```

POST`/{key}/message/button_action`— Botões de ação (URL, Call, Copy)

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/button_action" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "559999999999",
    "provider": "whatsapp",
    "header": {"title": "Actions"},
    "text": "Choose an action",
    "footer": "Select one",
    "buttons": [
      {"type": "cta_url", "url": "https://api-wa.me", "text": "Visit website"},
      {"type": "cta_call", "phone_number": "+559999999999", "text": "Call us"},
      {"type": "cta_copy", "copy_code": "PROMO2025", "text": "Copy code"}
    ]
  }'
```

## Lista / Menu

POST`/{key}/message/list`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/list" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "559999999999",
    "buttonText": "Ver opções",
    "text": "Selecione uma opção:",
    "title": "Menu Principal",
    "footer": "Wame API",
    "sections": [
      {
        "title": "Serviços",
        "rows": [
          {"title": "Suporte", "description": "Falar com atendente", "rowId": "support"},
          {"title": "Vendas", "description": "Nossos produtos", "rowId": "sales"}
        ]
      }
    ]
  }'
```

## Enquete / Poll

POST`/{key}/message/survey`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/survey" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "name": "Do you like PHP?", "options": ["Yes", "No"]}'
```

POST`/{key}/message/poll`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/poll" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "name": "Favorite?", "values": ["PHP", "TypeScript", "Go"], "selectableCount": 1}'
```

## Cobrança via Pix

POST`/{key}/message/pix`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/pix" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "559999999999",
    "title": "Pizza Order",
    "text": "Your order details",
    "referenceId": "order-123",
    "code": "0020101021226700014br.gov.bcb.pix",
    "key": "23711695000115",
    "merchantName": "MY STORE",
    "keyType": "CNPJ",
    "items": [
      {"id": "1", "name": "Pizza G", "price": 45, "quantity": 2},
      {"id": "2", "name": "Soda", "price": 8, "quantity": 2}
    ],
    "subtotal": 106,
    "totalAmount": 106
  }'
```

## Evento, Pin e Call Link

POST`/{key}/message/event`

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/event" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "559999999999",
    "name": "Team Meeting",
    "description": "Weekly sync",
    "startTime": "2025-01-15T14:00:00Z",
    "locationName": "Office",
    "locationAddress": "123 Main St"
  }'
```

POST`/{key}/message/pin`— Fixar

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/pin" \
  -H "Content-Type: application/json" \
  -d '{"id": "MESSAGE_ID", "duration": 604800}'
```

POST`/{key}/message/unpin`— Desfixar

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/unpin" \
  -H "Content-Type: application/json" \
  -d '{"id": "MESSAGE_ID"}'
```

POST`/{key}/message/call-link`— Enviar link de chamada

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/call-link" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "type": "video", "caption": "Join the meeting"}'
```

POST`/{key}/message/create-call-link`— Criar link (sem enviar)

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/create-call-link" \
  -H "Content-Type: application/json" \
  -d '{"type": "video"}'
```

## Detalhes, Mídia e Outros

GET`/{key}/message/{messageId}`— Detalhes

curl

copiar

```
curl "https://us.api-wa.me/YOUR_KEY/message/MESSAGE_ID"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": {
    "key": {
      "remoteJid": "[email protected]",
      "fromMe": true,
      "id": "3EB0A1B2C3"
    },
    "message": {
      "extendedTextMessage": {
        "text": "Hello!"
      }
    },
    "messageTimestamp": "1718900000",
    "status": "READ"
  }
}
```

GET`/{key}/message/{messageId}/media`— Download mídia

curl

copiar

```
# JSON com base64
curl "https://us.api-wa.me/YOUR_KEY/message/MESSAGE_ID/media?format=json"

# Download binário
curl "https://us.api-wa.me/YOUR_KEY/message/MESSAGE_ID/media?format=binary" -o media.jpg
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."
}
```

POST`/{key}/message/product`— Produto do catálogo

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/product" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "businessOwnerJid": "[email protected]", "productId": "123", "catalogId": "456"}'
```

POST`/{key}/message/group-invite`— Convite de grupo

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/group-invite" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "groupJid": "[email protected]", "groupName": "Devs", "inviteCode": "CODE"}'
```

POST`/{key}/message/request-phone`— Solicitar telefone

curl

copiar

```
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/request-phone" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999"}'
```

## Responder Mensagem

Use `/{key}/message/{id}/{type}` para responder. Mesmo body do envio normal.

curl

copiar

```
# Responder com texto
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/ORIGINAL_MSG_ID/text" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "text": "This is a reply!"}'

# Responder com imagem
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/ORIGINAL_MSG_ID/image" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "url": "https://example.com/photo.jpg", "caption": "Reply"}'

# Responder com vídeo
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/ORIGINAL_MSG_ID/video" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "url": "https://example.com/video.mp4"}'

# Responder com documento
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/ORIGINAL_MSG_ID/document" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "url": "https://example.com/file.pdf", "mimetype": "application/pdf"}'

# Responder com áudio
curl -X POST "https://us.api-wa.me/YOUR_KEY/message/ORIGINAL_MSG_ID/audio" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999", "url": "https://example.com/audio.mp3"}'

# Responder com botões, pix, título, contato, localização
# Mesmo padrão: POST /{key}/message/{id}/button_reply
# POST /{key}/message/{id}/button_action
# POST /{key}/message/{id}/pix
# POST /{key}/message/{id}/title
# POST /{key}/message/{id}/contact
# POST /{key}/message/{id}/location
```

## Chat

curl

copiar

```
# Listar chats
curl "https://us.api-wa.me/YOUR_KEY/chat"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": [
    {
      "id": "[email protected]",
      "name": "Raphael",
      "timestamp": 1718900000,
      "unreadCount": 3
    },
    {
      "id": "[email protected]",
      "name": "Developers",
      "timestamp": 1718899000,
      "unreadCount": 0
    }
  ]
}
```

curl

copiar

```
# Mensagens de um chat (paginado)
curl "https://us.api-wa.me/YOUR_KEY/chat/[email protected]&page=1&limit=20"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": [
    {
      "key": {
        "remoteJid": "[email protected]",
        "fromMe": false,
        "id": "3EB0A1B2C3"
      },
      "message": {
        "extendedTextMessage": {
          "text": "Hello!"
        }
      },
      "messageTimestamp": "1718900000",
      "status": "READ"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 150
}
```

curl

copiar

```
# Marcar como lido
curl -X PATCH "https://us.api-wa.me/YOUR_KEY/[email protected]&action=markRead&value=true"

# Fixar chat
curl -X PATCH "https://us.api-wa.me/YOUR_KEY/[email protected]&action=pin&value=true"

# Deletar chat
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/[email protected]"
```

#### Presença, Mensagens Temporárias e Privacidade

curl

copiar

```
# Inscrever presença
curl -X POST "https://us.api-wa.me/YOUR_KEY/chat/presence/subscribe" \
  -H "Content-Type: application/json" \
  -d '{"jid": "[email protected]"}'

# Mensagens temporárias (7 dias)
curl -X POST "https://us.api-wa.me/YOUR_KEY/chat/disappearing" \
  -H "Content-Type: application/json" \
  -d '{"jid": "[email protected]", "expiration": 604800}'

# Privacidade
curl "https://us.api-wa.me/YOUR_KEY/chat/privacy"
```

## Chamadas

curl

copiar

```
# Fazer chamada
curl -X POST "https://us.api-wa.me/YOUR_KEY/call" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999"}'
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": {
    "callId": "A1B2C3D4E5F6",
    "peerJid": "[email protected]"
  }
}
```

curl

copiar

```
# Aceitar chamada
curl -X POST "https://us.api-wa.me/YOUR_KEY/call/accept" \
  -H "Content-Type: application/json" \
  -d '{"callId": "CALL_ID", "callFrom": "[email protected]"}'

# Rejeitar chamada
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/call/CALL_ID/[email protected]"

# Encerrar chamada
curl -X POST "https://us.api-wa.me/YOUR_KEY/call/end" \
  -H "Content-Type: application/json" \
  -d '{"callId": "CALL_ID", "peerJid": "[email protected]"}'
```

## Etiquetas / Labels

curl

copiar

```
# Listar etiquetas
curl "https://us.api-wa.me/YOUR_KEY/labels"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": [
    {
      "id": "1",
      "name": "New Customer",
      "color": 1
    },
    {
      "id": "2",
      "name": "VIP",
      "color": 2
    },
    {
      "id": "3",
      "name": "Pending Payment",
      "color": 3
    }
  ]
}
```

curl

copiar

```
# Criar etiqueta
curl -X POST "https://us.api-wa.me/YOUR_KEY/labels" \
  -H "Content-Type: application/json" \
  -d '{"name": "VIP"}'

# Chats com etiqueta
curl "https://us.api-wa.me/YOUR_KEY/labels/LABEL_ID"

# Adicionar etiqueta ao chat
curl -X POST "https://us.api-wa.me/YOUR_KEY/labels/LABEL_ID" \
  -H "Content-Type: application/json" \
  -d '{"to": "559999999999"}'

# Remover etiqueta do chat
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/labels/LABEL_ID/chat/559999999999"

# Deletar etiqueta
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/labels/LABEL_ID"
```

## Ações

curl

copiar

```
# Verificar número registrado
curl "https://us.api-wa.me/YOUR_KEY/actions/registered?number=559999999999"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "registered": true
}
```

curl

copiar

```
# Deletar storage
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/actions/storage"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "message": "Storage deleted"
}
```

## Contatos

curl

copiar

```
# Listar contatos
curl "https://us.api-wa.me/YOUR_KEY/contacts"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": [
    {
      "id": "[email protected]",
      "name": "Raphael",
      "notify": "Raphael S.",
      "imgUrl": "https://pps.whatsapp.net/..."
    },
    {
      "id": "[email protected]",
      "name": "João",
      "notify": "João"
    }
  ]
}
```

curl

copiar

```
# Perfil do contato
curl "https://us.api-wa.me/YOUR_KEY/contacts/559999999999"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": {
    "id": "[email protected]",
    "name": "Raphael",
    "notify": "Raphael S.",
    "imgUrl": "https://pps.whatsapp.net/..."
  }
}
```

curl

copiar

```
# Adicionar contato
curl -X POST "https://us.api-wa.me/YOUR_KEY/contacts" \
  -H "Content-Type: application/json" \
  -d '{"number": "559999999999", "name": "João Silva"}'

# Remover contato
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/contacts/559999999999"

# Bloquear / Desbloquear
curl -X PATCH "https://us.api-wa.me/YOUR_KEY/contacts/559999999999?action=block"
curl -X PATCH "https://us.api-wa.me/YOUR_KEY/contacts/559999999999?action=unblock"

# Listar bloqueados
curl "https://us.api-wa.me/YOUR_KEY/contacts/blocked"

# Status do contato
curl "https://us.api-wa.me/YOUR_KEY/contacts/559999999999/status"

# Limpar sessão
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/contacts/559999999999/session"

# Resolver LIDs
curl -X POST "https://us.api-wa.me/YOUR_KEY/contacts/resolve-lids" \
  -H "Content-Type: application/json" \
  -d '{"lids": ["lid1@lid", "lid2@lid"]}'
```

## Grupos

curl

copiar

```
# Listar grupos
curl "https://us.api-wa.me/YOUR_KEY/groups"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": [
    {
      "id": "[email protected]",
      "subject": "Developers",
      "owner": "[email protected]",
      "creation": 1700000000,
      "desc": "Dev team group",
      "participants": [
        {
          "id": "[email protected]",
          "admin": "superadmin"
        },
        {
          "id": "[email protected]",
          "admin": null
        }
      ]
    }
  ]
}
```

curl

copiar

```
# Detalhes do grupo
curl "https://us.api-wa.me/YOUR_KEY/groups/[email protected]"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": {
    "id": "[email protected]",
    "subject": "Developers",
    "owner": "[email protected]",
    "creation": 1700000000,
    "desc": "Dev team group",
    "participants": [
      {
        "id": "[email protected]",
        "admin": "superadmin"
      },
      {
        "id": "[email protected]",
        "admin": "admin"
      },
      {
        "id": "[email protected]",
        "admin": null
      }
    ]
  }
}
```

curl

copiar

```
# Criar grupo
curl -X POST "https://us.api-wa.me/YOUR_KEY/groups" \
  -H "Content-Type: application/json" \
  -d '{"name": "Developers", "participants": ["559999999999"]}'

# Atualizar grupo
curl -X PUT "https://us.api-wa.me/YOUR_KEY/groups/[email protected]" \
  -H "Content-Type: application/json" \
  -d '{"name": "New Name", "description": "New description"}'

# Configurações
curl -X PATCH "https://us.api-wa.me/YOUR_KEY/groups/[email protected]?setting=announcement"
# setting: announcement, not_announcement, locked, unlocked

# Sair do grupo
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/groups/[email protected]"
```

#### Participantes

curl

copiar

```
# Membros
curl "https://us.api-wa.me/YOUR_KEY/groups/[email protected]/members"

# Adicionar participantes
curl -X POST "https://us.api-wa.me/YOUR_KEY/groups/[email protected]/participants" \
  -H "Content-Type: application/json" \
  -d '{"participants": ["559999999999"]}'

# Remover participantes
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/groups/[email protected]/participants" \
  -H "Content-Type: application/json" \
  -d '{"participants": ["559999999999"]}'

# Promover / Rebaixar
curl -X PATCH "https://us.api-wa.me/YOUR_KEY/groups/[email protected]/role?action=promote" \
  -H "Content-Type: application/json" \
  -d '{"participants": ["559999999999"]}'

# Aprovação de participantes
curl "https://us.api-wa.me/YOUR_KEY/groups/[email protected]/request_participants_list"
curl -X PUT "https://us.api-wa.me/YOUR_KEY/groups/[email protected]/request_participants_list" \
  -H "Content-Type: application/json" \
  -d '{"participants": ["559999999999"], "action": "approve"}'
```

#### Convites e Imagem

curl

copiar

```
# Código de convite
curl "https://us.api-wa.me/YOUR_KEY/groups/[email protected]/invite"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "inviteCode": "AbCdEfGhIjKl"
}
```

curl

copiar

```
# Info de um convite
curl "https://us.api-wa.me/YOUR_KEY/groups/invite/info?code=INVITE_CODE"

# Atualizar foto do grupo
curl -X PUT "https://us.api-wa.me/YOUR_KEY/groups/[email protected]/picture" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/photo.jpg"}'

# Remover foto
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/groups/[email protected]/picture"
```

## Comunidade

curl

copiar

```
# Listar comunidades
curl "https://us.api-wa.me/YOUR_KEY/community"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": [
    {
      "id": "[email protected]",
      "name": "My Community",
      "subject": "Tech",
      "description": "Technology community",
      "participants": [
        {
          "id": "[email protected]",
          "admin": "superadmin"
        }
      ]
    }
  ]
}
```

curl

copiar

```
# Detalhes
curl "https://us.api-wa.me/YOUR_KEY/community/COMMUNITY_ID"

# Criar comunidade
curl -X POST "https://us.api-wa.me/YOUR_KEY/community" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Community", "subject": "Tech"}'

# Atualizar
curl -X PUT "https://us.api-wa.me/YOUR_KEY/community/COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{"subject": "Updated", "description": "New description"}'

# Sair
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/community/COMMUNITY_ID"

# Foto
curl -X PUT "https://us.api-wa.me/YOUR_KEY/community/COMMUNITY_ID/picture" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/photo.jpg"}'

# Convite
curl -X POST "https://us.api-wa.me/YOUR_KEY/community/COMMUNITY_ID/invite"

# Remover participantes
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/community/COMMUNITY_ID/participants" \
  -H "Content-Type: application/json" \
  -d '{"participants": ["559999999999"]}'
```

#### Convites e Aprovação

curl

copiar

```
# Aceitar convite
curl -X POST "https://us.api-wa.me/YOUR_KEY/community/invite/accept" \
  -H "Content-Type: application/json" \
  -d '{"code": "INVITE_CODE"}'

# Info de convite
curl "https://us.api-wa.me/YOUR_KEY/community/invite/info?code=INVITE_CODE"

# Pendentes de aprovação
curl "https://us.api-wa.me/YOUR_KEY/community/COMMUNITY_ID/request_participants_list"
curl -X PUT "https://us.api-wa.me/YOUR_KEY/community/COMMUNITY_ID/request_participants_list" \
  -H "Content-Type: application/json" \
  -d '{"participants": ["559999999999"], "action": "approve"}'
```

#### Grupos e Configurações

curl

copiar

```
# Criar grupo na comunidade
curl -X POST "https://us.api-wa.me/YOUR_KEY/community/COMMUNITY_ID/group" \
  -H "Content-Type: application/json" \
  -d '{"subject": "Novo Grupo", "participants": ["559999999999"]}'

# Mensagens temporárias
curl -X POST "https://us.api-wa.me/YOUR_KEY/community/COMMUNITY_ID/ephemeral" \
  -H "Content-Type: application/json" \
  -d '{"expiration": 604800}'

# Configurações
curl -X PATCH "https://us.api-wa.me/YOUR_KEY/community/COMMUNITY_ID/settings" \
  -H "Content-Type: application/json" \
  -d '{"setting": "announcement"}'

# Modo de adição de membros
curl -X PATCH "https://us.api-wa.me/YOUR_KEY/community/COMMUNITY_ID/member-add-mode" \
  -H "Content-Type: application/json" \
  -d '{"mode": "admin_add"}'

# Aprovação de entrada
curl -X PATCH "https://us.api-wa.me/YOUR_KEY/community/COMMUNITY_ID/join-approval" \
  -H "Content-Type: application/json" \
  -d '{"mode": "on"}'
```

## Business / Catálogo

curl

copiar

```
# Listar catálogo
curl "https://us.api-wa.me/YOUR_KEY/business/catalog?limit=10"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": [
    {
      "name": "Premium T-Shirt",
      "description": "100% cotton",
      "currency": "BRL",
      "price": 79.9,
      "images": [
        {
          "url": "https://example.com/photo.jpg"
        }
      ]
    }
  ],
  "cursor": "next_page_token"
}
```

curl

copiar

```
# Collections
curl "https://us.api-wa.me/YOUR_KEY/business/collections?limit=10"

# Criar produto
curl -X POST "https://us.api-wa.me/YOUR_KEY/business/catalog/product" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Premium T-Shirt",
    "description": "100% cotton",
    "originCountryCode": "BR",
    "currency": "BRL",
    "price": 79.90,
    "images": [{"url": "https://example.com/photo.jpg"}]
  }'

# Atualizar produto
curl -X PUT "https://us.api-wa.me/YOUR_KEY/business/catalog/product/PRODUCT_ID" \
  -H "Content-Type: application/json" \
  -d '{"name": "Premium T-Shirt v2", "price": 89.90}'

# Deletar produto
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/business/catalog/product/PRODUCT_ID"

# Detalhes de um pedido
curl "https://us.api-wa.me/YOUR_KEY/business/order/ORDER_ID?token=ORDER_TOKEN"
```

## Newsletter / Canal

curl

copiar

```
# Criar newsletter
curl -X POST "https://us.api-wa.me/YOUR_KEY/newsletter" \
  -H "Content-Type: application/json" \
  -d '{"name": "Meu Canal", "description": "Descrição"}'
```

200 OKresponse

copiar

```
{
  "status": 200,
  "message": "Newsletter created"
}
```

curl

copiar

```
# Metadata
curl "https://us.api-wa.me/YOUR_KEY/newsletter/metadata?type=invite&id=NEWSLETTER_ID"
```

200 OKresponse

copiar

```
{
  "status": 200,
  "data": {
    "id": "120363XXXXX@newsletter",
    "name": "Meu Canal",
    "description": "Descrição",
    "subscribers": 1250
  }
}
```

curl

copiar

```
# Subscribers e admins
curl "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/subscribers"
curl "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/admins"

# Seguir / Deixar de seguir
curl -X POST "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/follow"
curl -X POST "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/unfollow"
```

#### Atualizar Canal

curl

copiar

```
# Nome
curl -X PUT "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/name" \
  -H "Content-Type: application/json" \
  -d '{"name": "Novo Nome"}'

# Descrição
curl -X PUT "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/description" \
  -H "Content-Type: application/json" \
  -d '{"description": "Nova descrição"}'

# Foto
curl -X PUT "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/picture" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/photo.jpg"}'
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/picture"
```

#### Administração e Mensagens

curl

copiar

```
# Transferir propriedade
curl -X PUT "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/owner" \
  -H "Content-Type: application/json" \
  -d '{"newOwnerJid": "[email protected]"}'

# Rebaixar admin
curl -X PUT "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/demote" \
  -H "Content-Type: application/json" \
  -d '{"userJid": "[email protected]"}'

# Listar mensagens
curl "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/messages?count=10"

# Reagir
curl -X POST "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/react" \
  -H "Content-Type: application/json" \
  -d '{"serverId": "SERVER_ID", "reaction": "👍"}'

# Silenciar / Ativar
curl -X POST "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/mute"
curl -X POST "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID/unmute"

# Deletar newsletter
curl -X DELETE "https://us.api-wa.me/YOUR_KEY/newsletter/NEWSLETTER_ID"
```

## Status / Stories

curl

copiar

```
# Status texto
curl -X POST "https://us.api-wa.me/YOUR_KEY/status/text" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello World!", "statusJidList": []}'

# Status imagem
curl -X POST "https://us.api-wa.me/YOUR_KEY/status/image" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/photo.jpg", "caption": "Minha foto"}'

# Status vídeo
curl -X POST "https://us.api-wa.me/YOUR_KEY/status/video" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/video.mp4", "caption": "Meu vídeo"}'

# Status áudio
curl -X POST "https://us.api-wa.me/YOUR_KEY/status/audio" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/audio.mp3"}'

# Menção
curl -X POST "https://us.api-wa.me/YOUR_KEY/status/mention" \
  -H "Content-Type: application/json" \
  -d '{"jid": "[email protected]", "statusMsgId": "STATUS_MSG_ID"}'
```

## Contexto para AI

Use este arquivo de contexto para que assistentes de AI (Claude, ChatGPT, Copilot, etc.) entendam a REST API e possam te ajudar a programar integrações.

#### llms.txt

Arquivo com toda a documentação da REST API em formato otimizado para AI. Inclui todos os endpoints, parâmetros e exemplos.

[Iniciar conversa com Claude](https://claude.ai/new?q=Leia%20a%20documenta%C3%A7%C3%A3o%20da%20REST%20API%20em%20https%3A%2F%2Fup.api-wa.me%2Fllms.txt%20e%20me%20ajude%20a%20integrar%20a%20WAME%20API%20WhatsApp%20no%20meu%20projeto.) Copiar conteúdo [Baixar llms.txt](https://api-wa.me/llms.txt) [Visualizar](https://api-wa.me/llms.txt)

WAME REST API — Documentação

[Começar Agora](https://portal.api-wa.me/)

## Structured data

```json
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "WAME API",
  "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram e Messenger",
  "url": "https://api-wa.me",
  "inLanguage": "pt-BR",
  "publisher": {
    "@type": "Organization",
    "name": "WAME API",
    "url": "https://api-wa.me"
  }
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "WAME API",
  "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram e Messenger",
  "url": "https://api-wa.me",
  "logo": "https://api-wa.me/images/screenshot.png",
  "foundingDate": "2017",
  "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram e Messenger numa instância só. Desde 2017.",
  "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.",
  "knowsAbout": [
    "WhatsApp Cloud API oficial (Meta)",
    "API oficial de Instagram (Direct)",
    "API oficial de Messenger",
    "API multicanal Meta",
    "Meta Business Partner",
    "WhatsApp API",
    "API não oficial de WhatsApp",
    "automação de WhatsApp",
    "números virtuais",
    "webhooks"
  ],
  "sameAs": [
    "https://github.com/raphaelvserafim"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer support",
    "url": "https://api-wa.me/contact",
    "availableLanguage": [
      "Portuguese"
    ]
  }
}
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 0,
      "name": "Home",
      "item": "https://api-wa.me"
    },
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Documentação",
      "item": "https://api-wa.me/docs"
    }
  ]
}
```