MiSender API V1: empieza aquí

Conecta tu sistema con WhatsApp mediante la API transaccional de MiSender: acceso, primer envío y consulta de estado.

¿Qué es la API V1?

Es una interfaz server-to-server para enviar mensajes transaccionales, consultar templates y recibir estados de WhatsApp sin alterar tus campañas, Flujos ni operación diaria.

Qué puedes construir

  • Confirmaciones de pedidos, pagos, citas o reservaciones.
  • Notificaciones personalizadas desde un ERP, CRM, tienda o sistema propio.
  • Seguimiento de estados queued, sent, delivered, read y failed.
  • Recepción de mensajes y estados mediante webhooks firmados.

Antes de comenzar

01
UBÍCALO EN MISENDERAntes de comenzarConfiguración → API
app.misender.comReferencia visual
INTEGRA MISENDER A TU ECOSISTEMA¿Qué quieres conectar con MiSender?

Envía mensajes transaccionales, consulta templates y recibe estados en tiempo real.

● API ACTIVA
USO Y RENDIMIENTO

Mensajes aceptados 2

Aceptados 2Enviados 2Entregados 2Leídos 0Fallidos 0

Vista de referencia: busca este control en la sección indicada. Puede ajustarse ligeramente según el tamaño de tu pantalla.

  1. Tu cuenta debe estar activa y disponer del acceso anual a API.
  2. WhatsApp debe estar conectado correctamente.
  3. El owner debe entrar a Configuración → API y activar el interruptor API V1.
  4. En Nueva llave, escribe un nombre para el ambiente, presiona Generar llave y guárdala inmediatamente: se muestra completa una sola vez.
La API es transaccional.

Cada petición representa un destinatario y un mensaje. Para mensajería masiva utiliza Campañas; no envíes arreglos de teléfonos ni intentes convertir la API en una campaña.

Base URL y autenticación

Base URL: https://misender.com/api/v1

Authorization: Bearer ms_live_TU_LLAVE
Content-Type: application/json

Tu primer mensaje

curl -X POST https://misender.com/api/v1/messages \
  -H "Authorization: Bearer ms_live_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-84721-confirmado" \
  -d '{
    "to": "5215555555555",
    "type": "text",
    "text": {"body": "Tu pedido 84721 está listo.", "preview_url": false},
    "external_id": "pedido-84721",
    "metadata": {"pedido_id": 84721}
  }'

Respuesta

HTTP/1.1 202 Accepted
X-Request-Id: req_...

{
  "data": {
    "id": "msg_...",
    "status": "queued",
    "to": "5215555555555",
    "type": "text",
    "external_id": "pedido-84721",
    "metadata": {"pedido_id": 84721},
    "provider_message_id": null,
    "error": null,
    "created_at": "2026-10-02T18:30:00+00:00",
    "sent_at": null,
    "delivered_at": null,
    "read_at": null,
    "failed_at": null
  },
  "idempotent_replay": false
}

Qué significa 202 Accepted

MiSender validó y encoló la operación; todavía no significa que Meta la entregó. Conserva data.id y consulta GET /messages/{id} o escucha los webhooks.

Mapa de la documentación

¿Este artículo te resultó útil?

Tu respuesta nos ayuda a mejorar el centro de ayuda.