API e integraciones

Todo lo que puedes hacer desde las páginas Llamadas y Atención al cliente también se puede hacer desde tus propios sistemas: una plataforma de soporte, un sitio web, un sistema telefónico o tu propio software. En el panel de control, abre API e integraciones. Solo los propietarios y administradores de la organización pueden gestionarlas. Todo lo que se haga desde ahí se factura a la organización igual que si se hiciera desde el panel de control.

Encontrarás los detalles técnicos, ejemplos y la referencia completa de la API en la documentación para desarrolladores. En este artículo se explica para qué sirve cada parte.

Integraciones compatiblesPreguntar

Spiiksi funciona con estas herramientas. En la documentación para desarrolladores encontrarás una guía paso a paso para cada una.

Todas aparecen en conectores. Las llamadas iniciadas a través de una integración aparecen en Llamadas, donde los agentes pueden unirse a ellas.

Configurar números de teléfono y Teams

Twilio, SIP y Teams se configuran en el panel de control, en Conectores, dentro de la página API e integraciones:

• Twilio: completa los datos de Twilio, pulsa Conectar y pega la URL del webhook de voz (pégala en Twilio) en los ajustes de tu número en Twilio.
• SIP: crea un ID de entrada y copia el plan de marcado en tu centralita.
• Teams: crea un webhook saliente en el equipo y pega su token de seguridad.

Configurar aplicaciones de plataformas de soporte

Zendesk, Freshdesk, Salesforce y Genesys Cloud se instalan desde esas herramientas. Crea una clave de API para la aplicación (más abajo), descarga la aplicación desde su guía y sigue los pasos que se indican.

Claves de APIPreguntar

Tus sistemas usan una clave de API para comunicarse con Spiiksi. En autenticación se explica cómo enviar las claves con cada solicitud.

1. En Claves de API, indica para qué sirve la clave, por ejemplo, «Zendesk».
2. Elige el Modo: En directo para el uso real o Prueba para hacer pruebas (más abajo).
3. En Qué puede hacer la clave, deja todas las opciones activadas o permite solo lo que necesite el sistema; por ejemplo, traducir texto o consultar llamadas.
4. Pulsa Crear clave y cópiala enseguida. No volverá a mostrarse; guárdala en tu servidor, nunca en una página web.

Revocar desactiva una clave de inmediato, por ejemplo, si es posible que se haya filtrado. La lista muestra cuándo se usó cada clave por última vez.

Modo de pruebaPreguntar

Con una clave de Prueba, el texto recibe una traducción simulada, el audio de las llamadas pasa sin traducir y no se cobra nada. Solo accede a lo creado con claves de prueba, nunca a tus llamadas ni conversaciones reales. Úsala mientras desarrollas una integración y luego cambia a una clave En directo.

WebhooksPreguntar

Un webhook avisa a tu servidor cuando ocurre algo: se inicia o termina una llamada, se inicia un chat, recibe un mensaje o se cierra.

Consulta la sección webhooks de la documentación para desarrolladores para ver qué contiene cada notificación y cómo comprobar su firma.

1. En Webhooks, introduce la Dirección del webhook de tu servidor, elige los Eventos (o Todos los eventos) y pulsa Añadir webhook.
2. Copia el secreto de firma. No volverá a mostrarse; tu servidor lo utiliza para comprobar que cada envío realmente procede de Spiiksi.
3. Probar envía una notificación de prueba y muestra la respuesta de tu servidor.

Si tu servidor no responde, Spiiksi vuelve a intentarlo, dejando cada vez más tiempo entre intentos, durante aproximadamente un día y medio. Envíos muestra cada intento y si llegó a su destino; Volver a enviar repite uno. Si fallan diez envíos seguidos, el webhook se pausa. Cuando tu servidor vuelva a funcionar, activa de nuevo el interruptor Activo.

Aplicaciones OAuthPreguntar

Una aplicación OAuth está pensada para software que conectan muchas organizaciones, como una aplicación del marketplace de una plataforma de soporte. En lugar de compartir una clave de API, el administrador de cada organización autoriza la aplicación en Spiiksi y puede desconectarla en cualquier momento.

• Si creas una aplicación de este tipo: consulta OAuth en la documentación para desarrolladores y regístrala en Aplicaciones OAuth con su Nombre de la aplicación y sus URI de redirección (https, separadas por espacios). Recibirás un ID de cliente y un Secreto de cliente.
• Si conectas la aplicación de otra persona: Spiiksi muestra qué quiere hacer la aplicación y para qué organización; pulsa Permitir. Las aplicaciones conectadas aparecen en Aplicaciones conectadas a esta organización, donde Desconectar interrumpe su acceso de inmediato.

Chat en el sitio web y tus propias páginasPreguntar

• Un botón de chat para tu sitio web abre conversaciones de Atención al cliente; consulta Atención al cliente.
• También puedes abrir llamadas y chats dentro de tus propias páginas, en una ventana emergente o como parte de la página, con el SDK de JavaScript (/docs/javascript-sdk).

SeguridadPreguntar

• Guarda las claves de API y los secretos en tu servidor. Cualquiera que tenga una clave puede usarla, y los cargos se facturan a tu organización.
• Asigna a cada sistema su propia clave con los permisos que necesita, para poder revocarla sin interrumpir los demás.
• Spiiksi solo guarda una huella digital de cada clave de API y del secreto de cliente de cada aplicación, no la clave ni el secreto en sí. Por eso no se pueden volver a mostrar.