# Claves de API (SyBox)

Dónde: Configuración > Integraciones > Claves de API

Para qué sirve:

"Asigna a un programa externo su propia clave para realizar envíos a través de SyBox: el token de WhatsApp nunca sale del servidor y, si una clave se filtra, se puede revocar de forma independiente." Tu ERP, punto de venta o aplicación de escritorio utiliza una clave de SyBox sin necesidad de acceder a tus credenciales reales de WhatsApp.

Qué puede hacer un programa con una clave (según se detalla en la documentación pública para desarrolladores):

- Enviar mensajes de WhatsApp desde tu propio número conectado. Utiliza el mismo formato de peticiones que la WhatsApp Cloud API de Meta, por lo que una aplicación desarrollada para esta solo necesita una nueva dirección y una clave de SyBox. Admite texto, plantillas, imágenes, documentos y mensajes interactivos. Las respuestas y los errores se devuelven en el mismo formato que ofrece Meta.
- Registrar una reclamación desde tu propio sistema, como una queja anotada en tu ERP. El cliente ya debe existir en SyBox.
- Importar SMS desde un teléfono a la bandeja de entrada.
- Iniciar tus automatizaciones desde otro sistema (una clave del tipo "Iniciar una automatización").
- Buscar, leer y modificar tus contactos desde otro sistema (una clave del tipo "Leer y actualizar contactos").

Quién puede acceder: el administrador principal y los miembros del equipo que cuenten con el permiso "Administrar canales".

El interruptor "Puerta de enlace de API":

En la parte superior de la pantalla de Claves de API encontrarás un interruptor llamado "Puerta de enlace de API". Está desactivado por defecto. Mientras permanezca apagado, ninguna clave funcionará y no podrás crear claves nuevas. Si lo intentas, verás el mensaje: "La puerta de enlace de API está desactivada. Actívala con el interruptor en la parte superior de esta pantalla antes de crear claves." El estado del interruptor se guarda en cuanto haces clic en él.

### Cómo activar la puerta de enlace y crear una clave

1. Ve a Configuración > Integraciones > Claves de API.
2. Activa el interruptor "Puerta de enlace de API".
3. Haz clic en "Nueva clave".
   ![Settings, API keys: keys that let another program send through SyBox, and the "New key" button](https://www.sybox.io/res/sybox/help/es/turn-on-the-gateway-and-create-a-key-3.webp?v=2a952141)
4. Selecciona el "Tipo de clave":
   - "Enviar por WhatsApp": el programa envía mensajes a tus clientes.
   - "Registrar una reclamación": el programa abre casos en SyBox. No puede enviar mensajes.
   - "Importar SMS desde un teléfono": un teléfono reenvía sus mensajes SMS a la bandeja de entrada.
   - "Iniciar una automatización": el programa inicia las automatizaciones cuyo "Empieza cuando" es "Otro programa llama a SyBox" (POST /v1/automation con el "phone" del cliente y, opcionalmente, "event" y "data"). No puede enviar mensajes. Consulta Configuración > IA y automatización > Automatizaciones.
   - "Leer y actualizar contactos": el programa busca contactos, lee uno y cambia su nombre, correo electrónico, campos de contacto y etiquetas (POST /v1/contacts/search, /get, /update y /labels). No puede enviar mensajes. La clave actúa como la persona que la creó: solo ve los contactos que esa persona puede ver, solo funciona si esa persona puede abrir la lista de contactos y ver números, y solo puede modificar contactos si esa persona puede editarlos. Si se desactiva a esa persona, la clave deja de funcionar.
5. Rellena el "Nombre del dispositivo o programa", por ejemplo "Equipo de oficina" o "Sistema contable". Asigna a cada dispositivo o programa su propia clave.
6. En las claves de tipo "Enviar por WhatsApp", define también:
   - "Envía desde": el número de WhatsApp emisor que utilizará esta clave (obligatorio).
   - "Permitir mensajes de texto libre": activado o desactivado.
   - "Permitir plantillas aprobadas": activado o desactivado. Al menos una de estas dos opciones debe estar activa; de lo contrario, verás: "Permite al menos texto libre o plantillas; de lo contrario, la clave no podrá enviar nada."
   - "Permitir envío de multimedia": activado o desactivado.
   - "Plantillas" (opcional): nombres de las plantillas separadas por comas. Déjalo vacío para autorizar cualquier plantilla.
   - "Países de destinatarios permitidos" (opcional): códigos de país de dos letras, por ejemplo ES,MX,CO. Déjalo vacío para permitir cualquier país.
   - "Envío permitido de" ... "Para": la franja horaria en la que la clave puede realizar envíos. Si introduces la misma hora en ambos campos, no habrá restricción de horario. Las horas corresponden a la zona horaria del espacio de trabajo.
   - "Límite diario de mensajes (0 = ilimitado)".
7. Para una clave de tipo "Importar SMS desde un teléfono", configura "Solo contactos y clientes". Si está activada, los SMS procedentes de cualquier otro número permanecerán en el teléfono y nunca llegarán a la bandeja de entrada. Desactívala únicamente si el teléfono es de uso estrictamente laboral.
8. Haz clic en Guardar.
9. Aparecerá una ventana con la "URL base" y la "Clave API". Cópialas de inmediato. "Copia esta clave ahora — solo se muestra una vez." Pégalas en la configuración de tu programa.

Qué muestra la tarjeta de la clave:

- El nombre de la clave y el número emisor (o la etiqueta de su tipo si no realiza envíos).
- Los últimos caracteres de la clave para que puedas distinguirla de las demás.
- El dato "usado por última vez", con fecha y hora, o bien "nunca".
- Las restricciones activadas: "Solo texto libre", "Solo plantillas", "sin multimedia", "Plantillas", países autorizados, horario de envío y el límite diario expresado como enviados hoy / límite / día. Una clave de SMS que admita cualquier remitente mostrará "Todos los números".

### Cómo modificar, pausar o eliminar una clave

1. Haz clic en Editar en la tarjeta de la clave. Puedes modificar su nombre, número y restricciones. El tipo de clave no se puede cambiar tras su creación y la clave en sí no se volverá a mostrar.
   ![To change, pause or delete a key: "Edit" marked on the screen in SyBox](https://www.sybox.io/res/sybox/help/es/change-pause-or-delete-a-key-1.webp?v=ed583326)
2. Haz clic en Habilitar / Deshabilitar para pausar una clave de forma temporal.
3. Haz clic en Eliminar y confirma: "¿Eliminar esta clave de API? Cualquier programa que aún la use deja de funcionar de inmediato."

**Q: He perdido mi clave de API. ¿Puedo volver a verla?**

No. Solo se muestra una única vez. Crea una clave nueva, configúrala en tu programa y después elimina la clave antigua.

**Q: Creo que una clave se ha filtrado. ¿Qué debo hacer?**

Elimina o deshabilita esa clave de inmediato. Solo dejará de funcionar esa clave concreta. Tu número de WhatsApp y las demás claves no se verán afectados.

**Q: La lista "Envía desde" está vacía.**

La lista solo muestra los números de WhatsApp conectados y activos. Conecta un número primero en Configuración > Mensajería > Canales.

**Q: Mi programa recibe un rechazo al intentar enviar un mensaje.**

Comprueba que la "Puerta de enlace de API" esté activada y que la clave esté en estado activo. Revisa también las restricciones de la clave: texto libre frente a plantillas, archivos multimedia, plantillas permitidas, países autorizados, horario de envío y límite diario. Recuerda que las reglas propias de WhatsApp siguen vigentes. Por ejemplo, el texto libre solo se puede enviar dentro de las 24 horas posteriores al último mensaje del cliente.

**Q: ¿Una clave de tipo "Registrar una reclamación" puede enviar también mensajes?**

No, por diseño. Una clave para registrar casos no puede escribir a los clientes y una clave de envío no puede crear casos. Utiliza una clave independiente para cada tarea.

**Q: Tengo una clave antigua de tipo "Recibir de un programa". ¿Sigue funcionando?**

Sí, las claves existentes de ese tipo siguen operativas. Ya no es posible crear claves nuevas con ese formato; utiliza "Registrar una reclamación" para ese tipo de tareas.

Source: https://www.sybox.io/es/help/api-keys