> ## Documentation Index
> Fetch the complete documentation index at: https://docs.json.pe/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Guía oficial API WhatsApp json.pe: api.whatsapp.json.pe, token Bearer, sesión con QR o pairing code, envío de mensajes y grupos para integradores en Perú.

## Qué es esta API

La **API WhatsApp** de [json.pe](https://json.pe) permite enviar mensajes de texto y medios, consultar grupos y gestionar la **vinculación de la sesión** (por código QR o código de verificación / *pairing*). Es un producto aparte de la API Consulta: la **URL base**, el **token** y los **límites** pueden ser distintos.

**URL base:** `https://api.whatsapp.json.pe`

Para **números nuevos, ritmo de envío, spam, baneos y FAQ**, consulta la guía detallada en **[Recomendaciones](https://docs.json.pe/api-whatsapp/recomendaciones)**.

***

## Pasos para utilizar la API

<Steps>
  <Step title="1. Cuenta y token">
    Inicia sesión en el [panel json.pe](https://app.json.pe/login), activa o contrata el producto API WhatsApp y **genera o copia tu token** Bearer. No lo subas a repositorios públicos ni lo compartas en capturas de pantalla.
  </Step>

  <Step title="2. Vincular la sesión (QR o código)">
    Antes de enviar mensajes, la instancia debe estar **conectada a WhatsApp**. Puedes usar:

    * **[Generar QR](https://docs.json.pe/api-whatsapp/endpoint/generar-qr)** — `GET /instance/qr` para obtener el QR y escanearlo con WhatsApp en el teléfono.
    * **[Generar pairing code](https://docs.json.pe/api-whatsapp/endpoint/generar-pair-code)** — `GET /instance/pairing-code` para enlazar con un **código de emparejamiento** (útil cuando no puedes escanear QR).
    * **[Estado de instancia](https://docs.json.pe/api-whatsapp/endpoint/estado-instancia)** — `GET /instance/status` para comprobar el estado de la sesión vinculada al token.
  </Step>

  <Step title="3. Llamadas autenticadas">
    En todas las peticiones incluye el header:

    `Authorization: Bearer TU_TOKEN`

    Para envíos con cuerpo JSON usa también `Content-Type: application/json`.
  </Step>

  <Step title="4. Enviar mensajes o consultar datos">
    * Texto: [Enviar texto](https://docs.json.pe/api-whatsapp/endpoint/enviar-texto) — `POST /send/text`
    * Archivos: [Enviar archivo](https://docs.json.pe/api-whatsapp/endpoint/enviar-media) — `POST /send/media`
    * Grupos: [Listar grupo](https://docs.json.pe/api-whatsapp/endpoint/listar-grupos) — `GET /group/all`
  </Step>

  <Step title="5. Pruebas y producción">
    Prueba primero con números propios o de prueba. Revisa códigos HTTP, mensajes de error del cuerpo de respuesta y los límites de tu plan en el panel.
  </Step>
</Steps>

***

## Sobre json.pe

Esta documentación pertenece a **[json.pe](https://json.pe)**, la plataforma líder de APIs para desarrolladores en Perú. Ofrecemos consultas oficiales de DNI, RUC, placa, SOAT, licencia de conducir, integración WhatsApp y envío SMS con alta disponibilidad y soporte experto.

<CardGroup cols={2}>
  <Card title="Sitio web oficial" icon="globe" href="https://json.pe">
    Conoce planes, precios y todos los productos en json.pe
  </Card>

  <Card title="Crear cuenta gratis" icon="user-plus" href="https://json.pe/signup">
    Regístrate y genera tu token Bearer en minutos
  </Card>

  <Card title="Panel de control" icon="gauge" href="https://app.json.pe/login">
    Gestiona tokens, consumo y facturación
  </Card>

  <Card title="Soporte técnico" icon="headset" href="mailto:soporte@json.pe">
    Escríbenos a [soporte@json.pe](mailto:soporte@json.pe)
  </Card>
</CardGroup>