Separar WaVoIP e CallLog

A API publica duas famílias de consulta. WaVoIP e CallLog têm caminhos próprios e devem ser tratados como fontes distintas. A documentação atual não define equivalência, abrangência relativa nem um schema comum entre elas.

Área de configuração do WaVoIP no Atendeu Rápido
A tela do WaVoIP ajuda a reconhecer o contexto da integração; ela não determina o formato devolvido pelas rotas da API.
  • Listagem WaVoIP: GET /v2/api/external/{ApiID}/wavoip/calls.
  • Detalhe WaVoIP: GET /v2/api/external/{ApiID}/wavoip/calls/{id}.
  • Listagem CallLog: GET /v2/api/external/{ApiID}/callLog/list.
  • Detalhe CallLog: GET /v2/api/external/{ApiID}/callLog/show/{id}.

Preparar uma consulta segura

Tela de gerenciamento de APIs do Atendeu Rápido
Use uma API autorizada e mantenha a credencial fora de capturas, URLs, chamados e logs de aplicação.
  1. 1

    Confirme que URL base, ApiID e token pertencem ao mesmo ambiente.

  2. 2

    Envie a credencial no cabeçalho Authorization: Bearer <TOKEN>; nunca inclua o token na URL.

  3. 3

    Escolha um período encerrado e com volume conhecido para a primeira validação.

  4. 4

    Comece pela listagem da família desejada e consulte o detalhe somente com um ID obtido nela.

  5. 5

    Registre apenas estado HTTP, horário, rota e identificador mascarado; evite guardar a resposta integral.

Listar chamadas com página e período

No exemplo exibido pela versão atual, as duas listagens apresentam os mesmos nomes de parâmetros de consulta: pageNumber é obrigatório; startDate e endDate são opcionais. Esse exemplo não publica valores padrão, origem da numeração, formato das datas, fuso, ordenação nem schema de resposta.

  • GET /v2/api/external/{ApiID}/wavoip/calls exige pageNumber e aceita startDate e endDate.
  • GET /v2/api/external/{ApiID}/callLog/list exige pageNumber e aceita startDate e endDate.
  • Os parâmetros page e limit não aparecem no exemplo exibido pela versão atual do Atendeu Rápido.
  • O fato de os nomes dos filtros coincidirem não torna as respostas equivalentes.
  1. 1

    Abra a documentação interativa da API no ambiente que será consultado.

  2. 2

    Informe pageNumber conforme a validação exibida nessa versão; não presuma que a primeira página seja 0 ou 1.

  3. 3

    Faça uma consulta controlada sem datas, quando o volume e a política de acesso permitirem, para validar autenticação e paginação.

  4. 4

    Confirme no formulário interativo o formato aceito antes de acrescentar startDate ou endDate.

  5. 5

    Consulte apenas uma família por vez e identifique a origem no seu registro interno.

  6. 6

    Mapeie chaves e tipos a partir da resposta do seu ambiente antes de implementar o parser.

Consultar um registro pelo ID

  • WaVoIP: GET /v2/api/external/{ApiID}/wavoip/calls/{id}.
  • CallLog: GET /v2/api/external/{ApiID}/callLog/show/{id}.
  • O contrato publicado não define o tipo de id, o schema de resposta nem o comportamento para um registro ausente.
  1. 1

    Liste os registros na família correta.

  2. 2

    Selecione um id devolvido pela própria listagem e mantenha a indicação de origem.

  3. 3

    Monte a rota de detalhe correspondente sem transformar ou completar o valor.

  4. 4

    Compare o registro com a interface usando o mesmo ambiente e período.

  5. 5

    Remova ou mascare dados pessoais antes de guardar evidências da validação.

Comparar com o Log de ligações

Tela do Log de ligações com filtros no Atendeu Rápido
A interface pode apresentar filtros, ações e colunas adicionais. Eles não devem ser convertidos em parâmetros ou campos da API sem contrato explícito.

Use a tela somente para conciliar registros autorizados. Recursos visuais como exportação, filtros por usuário ou situação e acesso a gravações não comprovam que as rotas externas ofereçam os mesmos recursos.

  1. 1

    Aplique na interface o período equivalente ao consultado, respeitando a interpretação exibida pela tela.

  2. 2

    Compare uma amostra pequena por identificadores e horários disponíveis.

  3. 3

    Anote diferenças sem alterar o retorno nem criar regras compensatórias.

  4. 4

    Se a origem de um registro não puder ser comprovada, mantenha WaVoIP e CallLog separados.

Resolver falhas e divergências

  • Acesso recusado: confirme URL base, ApiID, token e permissão da credencial sem ampliar o acesso desnecessariamente.
  • Listagem vazia: revise pageNumber e, se usados, startDate e endDate; confirme também se a família escolhida possui registros no período.
  • Data rejeitada: consulte a validação da documentação interativa atual; não tente formatos sucessivos em produção.
  • Detalhe não encontrado: obtenha novamente o id na listagem da mesma família e do mesmo ambiente.
  • Totais diferentes da interface: compare o mesmo intervalo e horário de coleta; fuso, limites e ordenação não estão definidos no contrato publicado.
  • Resposta sem os campos esperados: preserve uma amostra protegida e ajuste o parser somente após validar a versão do ambiente.
  • Timeout: evite retentativas paralelas e repetidas; aguarde, reduza a frequência e refaça uma consulta controlada.
  • Dado sensível no log: restrinja o acesso, remova a exposição e substitua o valor por uma versão mascarada.