Autenticación

API Credentials

A diferencia de Z-API, que usa el header Client-Token, funciona con un par de claves: Public Key y Secret Key. Para generar tus credenciales, entra en el menú Seguridad del panel: Seguridad.

Public Key

La Public Key la utiliza exclusivamente el SDK de conexión de canales. Con ella puedes conectar canales (WhatsApp, Telegram, etc.) directamente desde tu sistema, sin necesidad de entrar al panel de .

La Public Key se puede exponer en el frontend de tu aplicación, ya que sus permisos se limitan únicamente a la conexión de canales.

Ejemplo de uso con el SDK:

import { OmniZapi } from '@omni-zapi/connect';

const omni = new OmniZapi({
  publicKey: 'SU_PUBLIC_KEY'
});

Instala el SDK con npm: @omni-zapi/connect

Secret Key

La Secret Key se utiliza para autenticarse en las APIs de . Debe enviarse en el header Authorization como Bearer token.

La Secret Key nunca debe exponerse en el frontend. Úsala únicamente en el backend de tu aplicación.

Ejemplo de uso en las llamadas a la API:

curl -X POST https://api.omni.z-api.io/channels/SU_CANAL/token/SU_TOKEN/send-text \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SU_SECRET_KEY" \
  -d '{"phone": "5511999999999", "message": "¡Hola!"}'

Resumen

Clave	Uso	¿Se puede exponer en el frontend?
Public Key	SDK de conexión de canales	Sí
Secret Key	Llamadas a la API (header `Authorization`)	No, solo en el backend

Migración

Mensajes

API Credentials

Public Key

Secret Key

Resumen

​API Credentials

​Public Key

​Secret Key

​Resumen

API Credentials

Public Key

Secret Key

Resumen