NeoLogo

Dígitro Neo Interact CTI Computer Telephony Integration

Eventos de agente



Atençao: Nem todos os campos dos eventos são obrigatórios, podendo não estar presentes no evento, dependendo do contexto em que ocorreram.




on_login

Enviado no momento do login do agente

Campos Tipo Opcional Descrição
id string Identificador do agente na plataforma SaaS
agent string Login do agente
agent_alias string Nome do agente
timestamp number TimeStamp do evento (Segundos desde 1 de Janeiro de 1970)
state string Estado do agente
not_logged_in
ready_free
ready_service
pause
custom_pause
invalid_state_fail_pause 


  event: on_login
  data: {
    "id": 157,
    "agent": "agente1.neocti@digitro.com",
    "agent_alias": "Agente1 Neocti",
    "timestamp": 1726683625,
    "state": "not_logged_in",
  }




on_logout

Enviado no momento do logout do agente.

Campos Tipo Opcional Descrição
id string Identificador do agente na plataforma SaaS
agent string Login do agente
agent_alias string Nome do agente
timestamp number TimeStamp do evento (Segundos desde 1 de Janeiro de 1970)
dt_login string Data/Hora do login do agente (Ex: "2024-08-17 10:38:11") 


  event: on_logout
  data: {
    "id": 157,
    "agent": "agente1.neocti@digitro.com",
    "agent_alias": "Agente1 Neocti",
    "timestamp": 1726683694,
    "dt_login": "2024-09-18 18:20:25"
  }




on_state_change

Enviado nas alterações de estado do agente.

Campos Tipo Opcional Descrição
id string Identificador do agente na plataforma SaaS
agent string Login do agente
agent_alias string Nome do agente
timestamp number TimeStamp do evento (Segundos desde 1 de Janeiro de 1970)
dt_login string Data/Hora do login do agente (Ex: "2024-08-17 10:38:11")
state string Estado do agente
not_logged_in
ready_free
ready_service
pause
custom_pause
invalid_state_fail_pause
state_changed_by string * Entidade que executou a mudança de estado
system
<agente>
pause_name string * Nome da pausa (Se estiver em pausa)
pause_trigger string * Causa da pausa (Se estiver em pausa)
pause_id string * Id da pausa (Se estiver em pausa)
devices array * Lista de dispositivos de mídia que o agente utiliza
media_type
string * Tipo da mídia. Pode ser "voice" ou "chat"
quantity
number * Quantidade de instâncias da mídia que podem ser atendidas simultaneamente
handle_mode
string * Mode de atendimento da mídia. Pode ser "manual" ou "automatic"
branch string * Número do ramal VoIP associado à mídia voz, se houver


Exemplos

   event: on_state_change
   data: {
     "id": 112,
     "agent": "agente1.neocti@digitro.com",
     "agent_alias": "Agente1 Neocti",
     "timestamp": 1723892357,
     "dt_login": "2024-08-17 10:38:11",
     "state": "ready_free",
     "state_changed_by": "agente1.neocti@digitro.com",
     "devices": [
       {
         "media_type": "voice",
         "quantity": 1,
         "handle_mode": "manual"
       },
       {
         "media_type": "chat",
         "quantity": 5,
         "handle_mode": "auto"
       }
     ],
     "branch": "1003001"
   }


   event: on_state_change
   data: {
    "id": 112,
    "agent": "agente1.neocti@digitro.com",
    "agent_alias": "Agente1 Neocti",
    "timestamp": 1734619377,
    "dt_login": "2024-12-19 14:41:48",
    "state": "custom_pause",
    "pause_name": "Almoço",
    "pause_trigger": "manual",
    "pause_id": "ffc370a1-1dc8-46cf-9b3d-7c47999f3c2c",
    "state_changed_by": "agente1.neocti@digitro.com",
    "devices": [
      {
        "media_type": "voice",
        "quantity": 1,
        "handle_mode": "manual"
      },
      {
        "media_type": "chat",
        "quantity": 3,
        "handle_mode": "auto"
      }
    ],
    "branch": "1003001"
   }


  event: on_state_change
  data: {
    "id": "112",
    "agent": "agente1.neocti@digitro.com",
    "agent_alias": "Agente1 Neocti",
    "timestamp": 1723892362,
    "state": "ready_service",
  }


  event: on_state_change
  data: {
    "id": "113",
    "agent": "agente2.neocti@digitro.com",
    "agent_alias": "Agente2 Neocti",
    "timestamp": 1723892386,
    "state": "ready_free",
  }




on_agent_status

Enviado no momento da assinatura de eventos, de todos agentes determinados pelo filtro de eventos. Mesmo conteúdo da resposta do comando get_status

Campos Tipo Opcional Descrição
id string Identificador do agente na plataforma SaaS
agent string Login do agente
agent_alias string Nome do agente
dt_login string * Data/Hora do login do agente (Ex: "2024-08-17 10:38:11")
state string Estado do agente
not_logged_in
ready_free
ready_service
pause
custom_pause
invalid_state_fail_pause
pause_name string * Nome da pausa (Se estiver em pausa)
pause_id string * Id da pausa (Se estiver em pausa)
devices array * Lista de dispositivos de mídia que o agente utiliza
media_type
string * Tipo da mídia. Pode ser "voice" ou "chat"
quantity
number * Quantidade de instâncias da mídia que podem ser atendidas simultaneamente
handle_mode
string * Mode de atendimento da mídia. Pode ser "manual" ou "automatic"
calls array * Lista de chamadas que o agente está atendendo
media_type
string Tipo da mídia. Pode ser "voice" ou "chat"
interlocutor
string Identificação do interlocutor da chamada, pode ser um número telefônico
service
string Nome do serviço pela qual a chamada está sendo atendida
call_id
string Identificador da chamada
duration
number Tempo que a chamada está em andamento até o momento (em segundos)
call_type
string Direção da chamada. Pode ser "incoming" ou "outgoing"
classification_time
number Tempo em segundos para o agente classificar a chamada
0 (zero) se não há classificação configurada ou se for chamada pessoal
aftercallwork_time
number Tempo em segundos para o agente concluir o pós atendimento
0 (zero) se não há pós-atendimento configurado ou se for chamada pessoal
expectedhandletime
string Tempo esperado para o atendimento (em segundos)
branch string * Número do ramal VoIP associado à mídia voz, se houver


Exemplos

   event: on_agent_status
   data: {
    "id": "125",
    "agent": "agente3.neocti@digitro.com",
    "agent_alias": "Agente3 Neocti",
    "state": "offline",
    "devices": [
      {
        "media_type": "voice",
        "handle_mode": "manual",
        "quantity": 1,
        "branch": "1003014"
      },
      {
        "media_type": "chat",
        "handle_mode": "manual",
        "quantity": 7
      },
      {
        "media_type": "email",
        "handle_mode": "auto",
        "quantity": 0
      }
    ],
    "calls": [],
    "branch": "1003014"
  }


  event: on_agent_status
  data: {
    "id": "112",
    "agent": "agente1.neocti@digitro.com",
    "agent_alias": "Agente1 Neocti",
    "dt_login": "2024-10-15 19:28:21",
    "state": "handlingService",
    "devices": [
      {
        "media_type": "voice",
        "handle_mode": "manual",
        "quantity": 1,
        "branch": "1003001"
      },
      {
        "media_type": "chat",
        "handle_mode": "auto",
        "quantity": 5
      },
      {
        "media_type": "email",
        "handle_mode": "auto",
        "quantity": 3
      }
    ],
    "calls": [
      {
        "media_type": "chat",
        "interlocutor": "usuario",
        "service": "SAC",
        "call_id": "a0cc9594-bd06-4f5b-868d-4f31c02612b6",
        "duration": 25,
        "call_type": "inbound",
        "classification_time": 300,
        "after_call_work_time": 600,
        "expected_handle_time": 0
      },
      {
        "media_type": "voice",
        "interlocutor": "1001000",
        "service": "SAC",
        "call_id": "033625e3-f073-4fbe-939f-ad79e9a86685",
        "duration": 15,
        "call_type": "inbound",
        "classification_time": 300,
        "after_call_work_time": 601,
        "expected_handle_time": 0
      }
    ],
    "branch": "1003001"
  }