Agenda de Contatos no Portal Nyverra: comunicação sem ruído

Em qualquer atendimento, metade do tempo perdido está em descobrir com quem falar. O contato interno errado, o e-mail desatualizado, o telefone que ninguém encontra — pequenos atritos que somam horas por semana. A Agenda do Portal Nyverra ITSM existe para eliminar esse atrito.

Neste guia, você entende o que a Agenda guarda, por que o vínculo com o cliente importa e como ela se integra ao chamado e ao WhatsApp.

Interface do módulo no Portal Nyverra ITSM.

O que a Agenda é (e não é)

A Agenda é o cadastro de contatos e organizações relacionadas aos atendimentos. Não é a lista de usuários do sistema (isso fica em Usuários) nem o cadastro comercial do cliente (isso fica em Clientes) — é a camada de pessoas de contato para comunicação.

Área	O que guarda
Usuários	Quem faz login no sistema
Clientes	A organização atendida (multi-tenant)
Agenda	Pessoas de contato e empresas, com canais de comunicação

O que um contato carrega

• Identificação: nome, cargo, organização.
• Canais: telefone, celular e e-mail.
• Vínculo com o cliente: a qual organização o contato pertence.
• Observações: como e quando preferir contato, restrições, horários.

Esse vínculo é o que permite, no chamado, selecionar o solicitante correto — um usuário do sistema ou um contato cadastrado — e herdar o contexto do cliente.

Quem usa

Perfil	Uso típico
Operador / atendimento	Localizar e acionar o contato durante o atendimento
Backoffice / admin	Manter contatos atualizados
Atendimento via WhatsApp	Verificar o número e abrir conversa a partir do contato

Como usar no fluxo de atendimento

1. Cadastre o contato com nome, organização e canais — evite duplicidades.
2. Vincule ao cliente correto para herdar escopo e SLA.
3. No chamado, selecione o solicitante a partir da Agenda (usuário ou contato).
4. Use as ações diretas: ligar (tel:) e enviar e-mail (mailto:) a partir do contato.
5. Registre o retorno: anote no trâmite o que foi tratado por telefone/e-mail — o canal externo também faz parte da história do chamado.

Integração com o WhatsApp

Quando o módulo de WhatsApp está ativo, a Agenda ganha utilidade extra: é possível verificar se o número está no WhatsApp e abrir a conversa a partir do contato. Assim, o operador que recebe um pedido por telefone pode migrar a conversa para o canal oficial de mensagens sem perder o vínculo com o cliente.

Regras de negócio

Regra	Explicação
Escopo por cliente	Um contato pertence a uma organização; isso delimita visibilidade e SLA.
Sem duplicidade	Busque antes de criar; contato duplicado gera confusão no atendimento.
Privacidade	Dados de contato são PII — trate conforme LGPD e restrinja o acesso quando necessário.

Boas práticas

• Padronize o cadastro: nome completo, função, organização, canal preferido.
• Mantenha os dados vivos — contato desatualizado é pior que contato ausente.
• Vincule sempre ao cliente correto; facilita SLA, relatórios e comunicação.
• Registre no trâmite toda interação externa (telefone/e-mail), para a trilha ficar completa.

Erros comuns

Situação	O que fazer
Contato sem cliente vinculado	Vincule à organização para herdar escopo e SLA.
Duas pessoas parecem iguais	Busque por e-mail/telefone antes de criar um novo contato.
Comunicação fora do sistema	Traga o retorno para o trâmite; a história do chamado deve ser única.

Perguntas frequentes

Agenda é a mesma coisa que Usuários?
Não. Usuários acessam o sistema; a Agenda reúne pessoas de contato, que podem ou não ter login.

Um contato pode estar em vários clientes?
O vínculo é com a organização; se a pessoa atende várias, cadastre os vínculos corretos por cliente.

Posso falar com o contato pelo portal?
As ações de telefone/e-mail disparam os apps do dispositivo; o WhatsApp integra a conversa oficial.

Automatize via API

Contatos são expostos por API (/api/contatos), permitindo sincronizar a agenda com outras fontes (CRM, diretório). Referência em developer.nyverra.com.

Cenários de uso: a agenda no atendimento

1. Incidente que exige um contato específico. Um sistema de um cliente cai; o técnico precisa falar com o responsável de TI daquela empresa, não com qualquer pessoa. A Agenda entrega o contato correto, com telefone e e-mail, vinculado ao cliente — e o técnico aciona em segundos.

2. Comunicação por telefone documentada. A resolução veio por uma ligação. O operador registra o retorno no trâmite, mantendo a história do chamado completa mesmo quando parte da conversa foi externa.

3. Migração para o WhatsApp. O contato ligou; a conversa segue melhor por mensagem. Pela integração, o operador verifica o número e abre a conversa oficial sem perder o vínculo com o cliente.

4. Stakeholder informado. O gestor do cliente deve acompanhar um incidente crítico — a Agenda identifica quem é e como mantê-lo informado.

Higiene de dados: o que separa uma agenda útil de um cemitério de contatos

Uma agenda mal mantida é pior que nenhuma, porque gera confiança falsa. Algumas rotinas fazem diferença:

• Buscar antes de criar por e-mail e telefone, para evitar duplicidade.
• Definir contato principal por cliente — em crise, sabe-se a quem recorrer primeiro.
• Registrar preferências de contato (horário, canal) no campo de observações.
• Revisar periodicamente contatos de clientes ativos; remover/atualizar os inativos.
• Vincular ao cliente correto para herdar escopo e SLA.

Privacidade e LGPD

Uma agenda de contatos é, por natureza, um repositório de PII (nomes, telefones, e-mails). Trate com cuidado: restrinja o acesso conforme o necessário, evite exportações desnecessárias e tenha uma política de retenção. O objetivo é facilitar a comunicação — não criar um risco de dados.

Checklist de higiene da agenda

1. Busque por e-mail/telefone antes de criar um contato.
2. Defina o contato principal de cada cliente.
3. Padronize o formato (nome completo, função, organização).
4. Registre preferências de contato (canal, horário) nas observações.
5. Reveja periodicamente contatos de clientes ativos.
6. Restrinja o acesso e evite exportações desnecessárias (LGPD).

Perguntas frequentes adicionais

Qual a diferença entre usuário e contato?
O usuário faz login no sistema; o contato é uma pessoa de referência para comunicação, que pode ou não ter acesso.

A agenda integra com o WhatsApp?
Sim, quando o módulo está ativo: dá para verificar o número e abrir a conversa a partir do contato.

Como lidar com contatos que mudam de empresa?
Atualize o vínculo com o cliente correto; histórico antigo permanece nos chamados anteriores.

Conclusão

A Agenda é a ponte entre o atendimento e as pessoas. Com contatos bem mantidos e vinculados ao cliente, o Portal Nyverra ITSM reduz o tempo gasto procurando quem chamar e garante que a comunicação faça parte da história de cada chamado.