Saltar al contenido principal

Conectar Jira

MonoPbx se conecta a su Jira para que las funciones de llamadas puedan usarlo: las solicitudes abiertas del cliente en la pantalla de llamada, las incidencias creadas desde llamadas, las notas y registros de tiempo de cada llamada, y la llamada al cliente desde una incidencia. Esta página cubre la conexión, el mapeo de campos y la comprobación de estado. Las funciones de llamadas tienen su propia página, Jira y llamadas.

Para conectar necesita el permiso jira:write, y para ver la conexión, jira:read. El rol Owner integrado tiene ambos.

Elija cómo iniciar sesión​

ModoFunciona conCómo inicia sesión
Iniciar sesión con Atlassian (OAuth 2.0)Jira CloudUn administrador inicia sesión en Atlassian una vez. MonoPbx guarda los tokens de acceso y de actualización cifrados con la clave de su empresa.
Token de APIJira CloudUsted introduce el correo de la cuenta de Atlassian y un token de API. MonoPbx los guarda cifrados y nunca los vuelve a mostrar.

Para Iniciar sesión con Atlassian, su operador registra una aplicación OAuth 2.0 en la consola de desarrolladores de Atlassian, con la devolución de llamada https://<su PBX>/admin/jira y los ámbitos read:jira-work write:jira-work read:jira-user offline_access. Atlassian rota el token de actualización en cada renovación. MonoPbx guarda el nuevo antes de usarlo. Si Atlassian rechaza una renovación, la conexión aparece como revocada hasta que vuelva a conectarse.

Para crear un token de API, inicie sesión en id.atlassian.com, abra Seguridad y luego Tokens de API.

Desconectar elimina de MonoPbx todos los tokens y secretos. Atlassian no ofrece una forma de revocar el acceso desde nuestro lado, así que también elimine la aplicación de su cuenta de Atlassian en Aplicaciones conectadas.

Mapee los campos​

Los mapeos indican qué proyecto y tipo de incidencia de Jira usar para las incidencias nuevas, y qué campo de Jira guarda cada uno de nuestros valores.

Nuestro campoQué contiene
customer_phone, customer_emailEl número y el correo del cliente. customer_phone es también el campo que busca al cliente por número.
caller_number, called_numberLos números de la llamada.
call_id, call_direction, call_duration, recording_urlDatos de la llamada.
agent, queueEl agente y la cola que atendieron la llamada.

Cada valor es un identificador de campo de Jira, como customfield_10050. Las claves de proyecto y los identificadores se validan estrictamente, porque terminan en JQL y en las direcciones de Jira. Use los identificadores de campo de su sitio de Jira, no sus nombres.

Compruebe la conexión​

Seleccione Comprobar conexión en la página de configuración de Jira. MonoPbx comprueba que las credenciales funcionan, que los ámbitos concedidos bastan (solo OAuth) y que el proyecto mapeado existe.

Cuando una comprobación falla, la conexión aparece como con fallos o revocada, y los administradores de su empresa reciben la alerta JiraConnectionFailing hasta que una comprobación pase.

Webhook desde Jira (opcional)​

Active el webhook para ver los cambios de Jira en MonoPbx en cuanto ocurren. MonoPbx crea una dirección privada y un secreto. Ambos se muestran una sola vez, así que cópielos en Jira en Sistema, WebHooks, para los eventos issue created e issue updated.

MonoPbx acepta una entrega solo si la firma coincide con el secreto, la marca de tiempo tiene menos de cinco minutos y la entrega no había llegado antes. Los cambios aceptados aparecen como eventos jira.issue_changed, que contienen solo los identificadores y los nombres de los campos cambiados.

Antes de empezar​

  • Jira Cloud. Tanto Iniciar sesión con Atlassian como el token de API requieren Jira Cloud. Jira Server y Data Center no son compatibles.
  • HTTPS público. Jira debe poder llegar a la dirección del webhook, y esa dirección debe ser un nombre público.
  • Un campo de cliente mapeado. Sin el mapeo de customer_phone, no se encuentra a ningún cliente por número de teléfono.