---
title: "Guia da API do WhatsApp: endpoints essenciais e como usar | api-wa.me"
description: "Referência prática dos principais endpoints da API do WhatsApp: instância e conexão, envio de mensagens (texto, mídia, botões, listas), grupos, contatos e webhooks. Com a base URL e o padrão de autenticação."
url: "https://api-wa.me/blog/guia-api-whatsapp-endpoints"
language: "pt-BR"
og:type: "article"
og:site_name: "WAME API"
---

[Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Guia da API do WhatsApp: endpoints essenciais e como usar

Raphael Serafim· Publicado em 14 de junho de 2026· 7 min de leitura

Compartilhar

# Guia da API do WhatsApp: endpoints essenciais e como usar

Referência prática dos principais endpoints da API do WhatsApp: instância e conexão, envio de mensagens (texto, mídia, botões, listas), grupos, contatos e webhooks. Com a base URL e o padrão de autenticação.

Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/guia-api-whatsapp-endpoints.md)

**A API do WhatsApp da api-wa.me usa a base URL `https://us.api-wa.me` e o padrão `/{key}/...`, onde `{key}` é a chave da sua instância — que já serve de autenticação, sem precisar de header.** A partir daí, os endpoints se organizam em grupos: instância/conexão, mensagens, grupos, contatos e webhooks. Este guia resume os principais para você ter uma visão geral; a referência completa fica em [/docs](https://api-wa.me/docs).

## Conceitos básicos

- **Base URL:** `https://us.api-wa.me`
- **Autenticação:** a `key` da instância vai na URL — `https://us.api-wa.me/SUA_KEY/...`. Sem header.
- **Formato:** requisições JSON; números no formato internacional (só dígitos).

## Instância e conexão

| Método | Endpoint | O que faz |
| --- | --- | --- |
| `GET` | `/{key}/instance` | Status da conexão e QR Code |
| `POST` | `/{key}/instance` | Conectar (gera QR Code) |
| `POST` | `/{key}/instance/pairing-code` | Conectar por código de pareamento |
| `PUT` | `/{key}/instance` | Configurar webhooks |
| `PATCH` | `/{key}/instance` | Ajustes (auto-leitura, salvar mídia, etc.) |
| `DELETE` | `/{key}/instance` | Desconectar (logout) |

## Envio de mensagens

| Método | Endpoint | Tipo |
| --- | --- | --- |
| `POST` | `/{key}/message/text` | Texto |
| `POST` | `/{key}/message/image` | Imagem |
| `POST` | `/{key}/message/video` | Vídeo |
| `POST` | `/{key}/message/audio` | Áudio |
| `POST` | `/{key}/message/document` | Documento |
| `POST` | `/{key}/message/location` | Localização |
| `POST` | `/{key}/message/contact` | Contato |
| `POST` | `/{key}/message/button_reply` | Botões de resposta rápida |
| `POST` | `/{key}/message/button_action` | Botões de ação (URL/ligar/copiar) |
| `POST` | `/{key}/message/list` | Lista (menu) |
| `POST` | `/{key}/message/pix` | Pix |

Exemplo mínimo de envio de texto:

bash

Copiar

```
curl -X POST "https://us.api-wa.me/SUA_KEY/message/text" \
  -H "Content-Type: application/json" \
  -d '{ "to": "5566996852025", "text": "Olá!" }'
```

Para os detalhes de cada tipo, veja [Como enviar mensagens, botões e mídia](https://api-wa.me/blog/como-enviar-mensagem-whatsapp-api).

## Grupos e contatos

| Método | Endpoint | O que faz |
| --- | --- | --- |
| `GET` | `/{key}/groups` | Listar grupos |
| `POST` | `/{key}/groups` | Criar grupo |
| `POST` | `/{key}/groups/{id}/participants` | Adicionar participantes |
| `GET` | `/{key}/contacts` | Listar contatos |
| `GET` | `/{key}/contacts/{number}` | Perfil do contato |
| `GET` | `/{key}/actions/registered` | Checar se o número tem WhatsApp |

## Webhooks (receber eventos)

Para receber mensagens e eventos em tempo real, configure os webhooks com `PUT /{key}/instance`:

bash

Copiar

```
curl -X PUT "https://us.api-wa.me/SUA_KEY/instance" \
  -H "Content-Type: application/json" \
  -d '{
    "allowWebhook": true,
    "allowNumber": "all",
    "webhookMessage": "https://seu-site.com/webhook",
    "webhookConnection": "https://seu-site.com/webhook"
  }'
```

Você pode definir URLs separadas por tipo de evento (mensagem, grupo, conexão, QR Code, mensagens enviadas por você, histórico) e filtrar por número com `allowNumber`.

## Acelere com contexto para IA

A api-wa.me oferece um arquivo `llms.txt` com toda a referência em formato otimizado para assistentes de IA. Cole no **Claude, ChatGPT ou Cursor** e peça ajuda para montar a integração — a IA já entende todos os endpoints.

## Próximos passos

- [Como criar e integrar uma API de WhatsApp](https://api-wa.me/blog/como-criar-api-whatsapp) — do zero ao primeiro envio;
- [Documentação completa](https://api-wa.me/docs) — todos os endpoints e parâmetros;
- [API não oficial do WhatsApp: é segura?](https://api-wa.me/blog/api-nao-oficial-whatsapp) — boas práticas.

### Pronto para automatizar seu WhatsApp?

Crie sua conta gratuita e comece a enviar mensagens pela API em minutos.

[Começar grátis](https://portal.api-wa.me/sign-up)

## Perguntas frequentes

Qual é a base URL da API do WhatsApp da api-wa.me?+

A base URL é https://us.api-wa.me. Todos os endpoints seguem o padrão https://us.api-wa.me/{key}/... , onde {key} é a chave da sua instância.

Como funciona a autenticação da API?+

A autenticação é feita pela chave da instância (key) diretamente na URL, no formato /{key}/.... Não é necessário enviar header de autenticação.

Quais são os principais endpoints da API do WhatsApp?+

Os grupos principais são: instância e conexão (/{key}/instance), envio de mensagens (/{key}/message/text, /image, /button\_action, /list, etc.), grupos (/{key}/groups), contatos (/{key}/contacts) e configuração de webhooks (PUT /{key}/instance).

Onde encontro a documentação completa da API?+

A documentação completa, com todos os endpoints e parâmetros, está em /docs. Há também um arquivo de contexto para IA (llms.txt) que você pode colar no Claude ou ChatGPT para acelerar a integração.

## Continue lendo

[### Como criar um chatbot de IA com a API da OpenAI para responder no WhatsApp

Um webhook, uma chamada à API da OpenAI e uma resposta pela WAME API: o código completo de um chatbot de IA que atende no WhatsApp, Instagram e Messenger. Com memória por contato, controle de custo e o que fazer quando a IA não deve responder.](https://api-wa.me/blog/chatbot-ia-openai-whatsapp)[### Cobrança por Pix dentro do WhatsApp pela API: como enviar e o que muda na conversão

Mandar o código Pix no WhatsApp resolve o pior ponto da cobrança digital: o cliente não precisa sair do app. Como enviar a cobrança pela API, tratar a confirmação e evitar os erros que transformam a facilidade em suporte.](https://api-wa.me/blog/cobrar-pix-whatsapp-api)[### Erros da API do WhatsApp: o que cada um significa e como tratar

A mensagem não saiu e o log diz apenas 'erro ao enviar'. Os erros que você vai encontrar de verdade — janela fechada, número inválido, template não aprovado, limite atingido, instância caída — e o tratamento certo para cada um.](https://api-wa.me/blog/erros-api-whatsapp-como-tratar)

[Voltar ao blog](https://api-wa.me/blog)

## 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": {
    "@id": "https://api-wa.me/#organization",
    "@type": "Organization",
    "name": "WAME API",
    "url": "https://api-wa.me"
  }
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://api-wa.me/#organization",
  "name": "WAME API",
  "alternateName": [
    "WAME",
    "Wame API",
    "wame.api.br",
    "api-wa.me"
  ],
  "url": "https://api-wa.me",
  "logo": {
    "@type": "ImageObject",
    "url": "https://api-wa.me/images/web-app-manifest-512x512.png",
    "width": 512,
    "height": 512
  },
  "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.",
  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "INPI-BR",
    "name": "Pedido de registro de marca (INPI, classe NCL 42)",
    "value": "944724159"
  },
  "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/wame-api",
    "https://www.linkedin.com/company/wameapi",
    "https://www.instagram.com/wame.api/",
    "https://www.youtube.com/@wameapi"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer support",
    "url": "https://api-wa.me/contact",
    "availableLanguage": [
      "Portuguese"
    ]
  }
}
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Guia da API do WhatsApp: endpoints essenciais e como usar",
  "description": "Referência prática dos principais endpoints da API do WhatsApp: instância e conexão, envio de mensagens (texto, mídia, botões, listas), grupos, contatos e webhooks. Com a base URL e o padrão de autenticação.",
  "image": "https://api-wa.me/blog/guia-api-whatsapp-endpoints/opengraph-image",
  "datePublished": "2026-06-14",
  "dateModified": "2026-06-14",
  "author": {
    "@type": "Person",
    "name": "Raphael Serafim",
    "url": "https://github.com/raphaelvserafim",
    "sameAs": [
      "https://github.com/raphaelvserafim"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "api-wa.me",
    "logo": {
      "@type": "ImageObject",
      "url": "https://api-wa.me/images/screenshot.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://api-wa.me/blog/guia-api-whatsapp-endpoints"
  },
  "keywords": "documentação api whatsapp, whatsapp api documentation, docs whatsapp api, endpoints api whatsapp, api whatsapp documentação, referência api whatsapp",
  "inLanguage": "pt-BR"
}
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://api-wa.me"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog da API do WhatsApp",
      "item": "https://api-wa.me/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Guia da API do WhatsApp: endpoints essenciais e como usar",
      "item": "https://api-wa.me/blog/guia-api-whatsapp-endpoints"
    }
  ]
}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Qual é a base URL da API do WhatsApp da api-wa.me?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "A base URL é https://us.api-wa.me. Todos os endpoints seguem o padrão https://us.api-wa.me/{key}/... , onde {key} é a chave da sua instância."
      }
    },
    {
      "@type": "Question",
      "name": "Como funciona a autenticação da API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "A autenticação é feita pela chave da instância (key) diretamente na URL, no formato /{key}/.... Não é necessário enviar header de autenticação."
      }
    },
    {
      "@type": "Question",
      "name": "Quais são os principais endpoints da API do WhatsApp?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Os grupos principais são: instância e conexão (/{key}/instance), envio de mensagens (/{key}/message/text, /image, /button_action, /list, etc.), grupos (/{key}/groups), contatos (/{key}/contacts) e configuração de webhooks (PUT /{key}/instance)."
      }
    },
    {
      "@type": "Question",
      "name": "Onde encontro a documentação completa da API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "A documentação completa, com todos os endpoints e parâmetros, está em /docs. Há também um arquivo de contexto para IA (llms.txt) que você pode colar no Claude ou ChatGPT para acelerar a integração."
      }
    }
  ]
}
```