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
| Modo | Funciona con | Cómo inicia sesión |
|---|---|---|
| Iniciar sesión con Atlassian (OAuth 2.0) | Jira Cloud | Un 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 API | Jira Cloud | Usted 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 campo | Qué contiene |
|---|---|
customer_phone, customer_email | El número y el correo del cliente. customer_phone es también el campo que busca al cliente por número. |
caller_number, called_number | Los números de la llamada. |
call_id, call_direction, call_duration, recording_url | Datos de la llamada. |
agent, queue | El 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.