Cómo activar la API, crear y administrar llaves

Configura la API desde MiSender, crea llaves seguras y conoce los permisos incluidos.

Quién puede administrarla

La activación, las llaves y el webhook pertenecen a la cuenta y deben ser administrados por el owner. Un agente no debe recibir una llave del servidor.

Requisitos de acceso

Se requiere cuenta activa, suscripción vigente, acceso anual a API, API habilitada y llave válida. Una prueba o un plan mensual no habilitan esta capacidad.

Activar la API

01
UBÍCALO EN MISENDERActivar la APIConfiguración → API → Acceso y operación
app.misender.comReferencia visual
CENTRO DE CONFIGURACIÓNAcceso y operación

Administra credenciales, disponibilidad y webhooks desde una sola superficie.

CREDENCIALES

Acceso y llaves

Producción
Llaves creadas1 DE 2 ACTIVAS

Producciónms_live_GVghPVtuRYg6zm4L••••v5pl

CONFIGURACIÓN

Operación y eventos

API V1
Webhooks firmados
✓ message.received✓ message.sent✓ message.delivered✓ message.read✓ message.failed

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

  1. Inicia sesión como owner.
  2. Desde el menú operativo presiona Configuración.
  3. En el menú de Configuración abre API.
  4. Revisa que el acceso anual aparezca disponible.
  5. En Operación y eventos, activa el interruptor API V1.
  6. Presiona Guardar configuración.

Crear una llave

  1. En Acceso y llaves, localiza el campo Nueva llave.
  2. Escribe un nombre reconocible, por ejemplo Producción ERP o Pruebas tienda.
  3. Presiona Generar llave.
  4. Copia el valor completo en ese momento y guárdalo de forma segura. La llave comienza con ms_live_ y no vuelve a mostrarse completa.
No la copies en JavaScript, una app móvil o un repositorio.

Úsala exclusivamente desde tu servidor y almacénala en un gestor de secretos o variable de entorno.

Permisos incluidos

La pantalla actual no solicita elegir scopes uno por uno. MiSender asigna a cada llave los permisos V1 disponibles para la cuenta:

  • messages:send: crear mensajes.
  • messages:read: consultar mensajes creados por API.
  • templates:read: listar y consultar templates.
  • whatsapp:read: consultar el estado no sensible de la conexión.

Ejemplo de variable de entorno

MISENDER_API_KEY=ms_live_REEMPLAZA_ESTA_LLAVE

Rotación sin interrupción

MiSender permite hasta dos llaves activas al mismo tiempo. El indicador de la pantalla muestra cuántas estás utilizando.

  1. Crea una segunda llave.
  2. Actualiza tu servidor y comprueba una petición.
  3. En Llaves creadas, presiona Revocar junto a la anterior.

Revocar una llave detiene futuras solicitudes con ella, pero no elimina mensajes, contactos ni historial.

Probar la autenticación

curl https://misender.com/api/v1/whatsapp \
  -H "Authorization: Bearer $MISENDER_API_KEY"

Una llave inexistente o revocada devuelve 401 invalid_api_key; una llave válida sin el scope requerido devuelve 403 insufficient_scope.

¿Este artículo te resultó útil?

Tu respuesta nos ayuda a mejorar el centro de ayuda.