CENTRO PAULA SOUZA

ETEC FERNANDO PRESTES

CURSO TÉCNICO EM INFORMÁTICA

ANDERSON DE ARAÚJO SOUSA

ALLAN REIMBERG DE OLIVEIRA
LUIZ ANTONIO JANDOZA BARALDI
NATHAN REIMBERG DE OLIVEIRA
RENATO DE SOUSA XAVIER

IMPLANTAÇÃO DE API

ORGANIC INTELLIGENCE CORP.

Sorocaba – SP
2023
 TÉCNICO EM INFORMÁTICA

ANDERSON DE ARAÚJO SOUSA

ALLAN REIMBERG DE OLIVEIRA
LUIZ ANTONIO JANDOZA BARALDI
NATHAN REIMBERG DE OLIVEIRA
RENATO DE SOUSA XAVIER

IMPLANTAÇÃO DE API
ORGANIC INTELLIGENCE CORP.

Relatório Parcial Técnico -

Científico apresentado na disciplina
de Trabalho de Conclusão de Curso
para o curso de Técnico em
Informática da Etec. Prof. Fernando
Prestes.
Orientadora: Andréa Maria Fieri
Silva

Sorocaba – SP
2023
 Sumário

INTRODUÇÃO.....................................................................................................................................4
1. PERCEPÇÃO DA NECESSIDADE........................................................................................................4
2. LEVANTAMENTO DE DADOS...........................................................................................................5
2.1. Análise de custo-benefício.....................................................................................................6
2.2. Análise de mercado................................................................................................................6
3. ANÁLISE DO SISTEMA ATUAL................................................................................................6
4. PROJETO LÓGICO.....................................................................................................................7
i. Identificação do objetivo da API............................................................................................9
ii. Escolha da tecnologia.............................................................................................................9
iii. Design da API........................................................................................................................10
iv. Implantação da API...........................................................................................................10
v. Implementação da API..........................................................................................................10
vi. Testes e validação.............................................................................................................10
vii. Monitoramento e manutenção:........................................................................................10
5. CRONOGRAMA........................................................................................................................13
6. DOCUMENTAÇÃO DA API – INCLUSA NO DESENVOLVIMENTO.................................14
7. FLUXOGRAMA..........................................................................................................................14
8. ALGORITIMO.............................................................................................................................14
9. VERIFICAÇÃO DO PROCESSO DA API...............................................................................14
10. MANUTENÇAO APOS TESTES.........................................................................................14
11. CONSIDERAÇÕES FINAIS.................................................................................................14
REFERÊNCIAS BIBLIOGRÁFICAS.............................................................................................................15
APENDICE.............................................................................................................................................16
 1. INTRODUÇÃO

Fundada em 2000, com o objetivo de tornar-se mestre no ofício. Com um

atendimento incomparável, tem o compromisso de fornecer produtos de qualidade e
serviços excepcionais para que seus clientes.

Constantemente aprimorando para expandir ofertas a fim de melhor atender toda

a região.

A Bmtech localizada à Avenida Professor Arthur Fonseca, 199, na cidade de

Sorocaba – SP, realiza a gestão da área de TI, fornecendo consultores para
reestruturação e melhoria da infraestrutura, consultoria para implantação de novos
projetos e melhorias do ambiente. Fornecendo uma equipe de service desk para
manter a infraestrutura pensada e implantada oferecendo eficiência operacional.

A fim de atingirmos o objetivo da elaboração e criação de projeto executivo para

a instalação de API, e de acordo proposto na ementa do Trabalho de Conclusão de
Curso, do Curso Técnico em Informática da ETEC Fernando Prestes, inicialmente
faremos uma análise da relevância do tema proposto.

Com um levantamento bibliográfico, análise de cenário, experimentação e

pesquisa sobre o tema

Considerando ainda, a visão da entrega de qualidade duradoura, atendimento

com um número menor de requisições, com foco no alcance implementação de
padrões exclusivos de configuração baseados no segmento, e no entendimento da
rotina de cada cliente.

A implementação de um projeto que cumpra o que a empresa oferece aos

clientes é complexa e morosa, carecendo de atenção exclusiva de parte atuante no
projeto.

A empresa onde será implementado o projeto, qual seja a “BMTECH” hoje

enfrenta as mesmas dificuldades que muitas empresas no ramo de tecnologia.

A redução de custo se de forma direta e indiretamente por meio da diminuição de

tempo de parada operacional por motivos tecnológicos, além de aumentar
significativamente a segurança dos dados.
 As empresas se tornam pioneiras em seus negócios por utilizar a tecnologia
como parte integrante do que entrega ou simplesmente por não ser "atrapalhada"
pela má implantação e investimento desfocado.

A carência de profissionais qualificados, preparados e disponíveis no mercado de

trabalho, tornou-se um impedimento para que a equipe consiga concluir os trabalhos
com a excelência que a empresa e o mercado prezam.

Considerando que a Bmtech, presta assistência aos equipamentos da Linha

Apple, que são utilizados por seus e clientes, também por seus colaboradores, a
excelência na execução dos serviços mencionada anteriormente pode ser verificada
na execução dos serviços, quais sejam a formatação de equipamentos dada a
especificidade de equipamentos linha Aplle, configuração de redes, e servidores,
compartilhamento de impressoras e outros serviços pertinentes as atividades
desenvolvidas pela empresa.

Assim, portanto a rotina de trabalho está intrinsicamente, baseada na dissipação

de pequenos incidentes e no treinamento novos colaboradores, o que demanda
tempo e recursos, o que procrastina e implantação de novos projetos melhoria e
organização a empresa cliente.

A empresa tem implantado em seu portifólio de serviços a metodologia PDCA,

como ferramenta da gestão da qualidade e rotineira e atualmente seu principal
projeto é a gestão e aprimoramento da qualidade da prestação de serviços

2. LEVANTAMENTO DE DADOS

Feita a análise do cenário e de acordo com as informações fornecidas pelo

cliente BMTECH, durante a entrevista, foi possível obter algumas das principais
considerações para determinar a viabilidade do projeto e estas incluem:

2.1. Análise de custo-benefício

É importante determinar se os custos do projeto justificam o benefício que

será obtido. Isso envolve avaliar tanto os custos diretos do projeto, como também os
custos indiretos e as receitas geradas. De acordo com a metodologia ITIL, que envolve
uma séria de boas práticas sobre gestão de TI, no tocante a infraestrutura da área,
manutenção e operação dos serviços de TI, onde a aplicabilidade engloba os setores
operacionais e estratégicos, promovendo uma melhor entrega de serviços aos clientes.
Dessa forma pudemos avaliar que a relação custo-benefício se justifica considerando
eventual aumento da produtividade.

2.2. Análise de mercado

É importante determinar se existe demanda suficiente para o produto ou

serviço que será criado pelo projeto. Isso envolve entender as necessidades dos
clientes, o tamanho do mercado, a concorrência e as tendências do setor.

Utilizando a ferramenta de gestão análise SWOT como ferramenta de gestão

baseada no estudo das forças, fraquezas, oportunidades e ameaças objetivo foi
compreender exatamente os pontos fortes e fracos que se destacam em um cenário
competitivo, bem como as brechas de mercado.

3. ANÁLISE DO SISTEMA ATUAL

Na nossa proposta, ao entender as forças, fraquezas, oportunidades e

ameaças, a empresa passara por todos os fatores necessários para a implantação
da API. A empresa poderá aplicá-la como parte da pesquisa de mercado preliminar
antes do lançamento de um novo produto, de modo a viabilizar a ideia. Ou pode
realizar a análise diante de uma queda de market share, que obriga a organização a
rever sua posição no mercado e entender como pode tomar o topo da concorrência.

Ao entender a análise SWOT fica evidente que, além de fornecer um

panorama geral do cenário competitivo, também oferece uma visão de futuro da sua
operação e da sua cadeia de valor.

3) Análise técnica: É importante avaliar se o projeto pode ser executado com

sucesso do ponto de vista técnico. Isso envolve avaliar a tecnologia necessária, os
recursos disponíveis e as habilidades da equipe.
 4) Análise de risco: É importante avaliar os riscos associados ao projeto,
incluindo riscos financeiros, legais, de mercado e operacionais. Isso envolve
identificar os principais riscos e desenvolver planos de contingência para mitigá-los.

5) Análise de cronograma: É importante determinar se o projeto pode ser

concluído dentro do prazo disponível. Isso envolve avaliar os recursos necessários,
as tarefas que precisam ser realizadas e as dependências entre elas.

Uma vez que essas considerações foram avaliadas a viabilidade do projeto foi
determinada, e a tomada de decisão informada e deu-se início ao projeto.

É importante lembrar que a viabilidade de um projeto pode mudar ao longo do

tempo, de modo que a análise deve ser atualizada regularmente para garantir que o
projeto permaneça viável.

4. PROJETO LÓGICO

A Bmtech é uma prestadora de serviços que atua como T.I no interior de

outras empresas de variados setores, sua atuação inicia no reconhecimento das
necessidades e a elaboração do projeto de melhoria para o parque tecnológico do
cliente.

Após o término do planejamento, realiza a organização do ambiente

padronizando servidores e estações de trabalho de acordo com o cronograma.

A empresa tem em seu portifólio de serviços o suporte service desk

atendendo solicitações realizadas pelos canais de atendimento e gerindo os serviços
de infraestrutura necessários durante o período de contrato.

O fluxo de atendimento começa com o registro da solicitação na plataforma

Freshdesk, seguido da primeira resposta o Técnico faz o reconhecimento do
problema através de informações obtidas através do acesso remoto ou se
deslocando até o ambiente onde o erro foi apresentado.

Após classificar a solicitação e descrever os testes realizados, se necessário,

o técnico escala a solicitação a um dos analistas para que a tratativa seja aplicada.
 As solicitações contam com um indicador de prioridade dividido em quatro
níveis (Baixo, Médio, Alto e Urgente) que ajudam na organização da ordem de
atendimento na existência de fila. O atendimento dos tickets pode ser feito no
momento da solicitação (médio e urgente) ou ser agendado (baixo e médio), contam
com a classificação do tipo de atendimento, campo para registro do número de
controle do equipamento e o campo de status, apresentado em 10 possíveis estados
que são: Aberto, agendado, em atendimento, em andamento, fechado, pendente,
pendente primeiro contato, pendente cliente, pendente terceiro e resolvido.

Dentro do tema proposto, neste TCC passamos ao seu desenvolvimento e

como mencionado anteriormente, pretendemos demonstrar a viabilidade do projeto,
de implantação e implementação de API, que depende de vários fatores, incluindo o
custo, o tempo necessário para a conclusão, a disponibilidade de recursos, a
complexidade do projeto, os riscos envolvidos e o potencial retorno financeiro.

a. Sistema Proposto

Quando um ticket é atualizado para o status “Em Atendimento” uma tarefa é

criada no Google Agenda com o horário da atualização de status, com a previsão de
término baseada no SLA definido em contrato.

Ao ticket ser atualizado para o status “Em andamento”, uma atividade será
criada e terá uma cor padrão para todos os analistas. No caso de existir uma tarefa
criada para o ticket que sofreu a atualização de status, a mesma sofrerá alteração
mantendo o padrão estabelecido para as tarefas que representam atividades com
status “Em andamento”. Essa cor será alterada de acordo com a quantidade de
atividades em andamento que contam com a participação do mesmo analista (com 1
atividade com status “Em andamento” a cor da tarefa será laranja; 2 ou mais
atividades serão mostradas com a cor definida para as tarefas que representam os
atendimentos do analista).

Quando o status for atualizado para “Agendado” uma nota será adicionada no
ticket orientando o agente a criar a tarefa na agenda. A alteração do status será
automática após checagem de dados na agenda do agente
 Os tickets com status “Pendente” e “Em Aberto” não serão visualizados no
calendário. Cada Agente terá uma cor para atividades em atendimento para facilitar
a visualização do calendário.

Um projeto de implantação de API envolve a criação e disponibilização de um

conjunto de interfaces de programação de aplicativos (APIs) para uso por
desenvolvedores de software e outros usuários.

As APIs podem ser usadas para acessar informações de um sistema ou

serviço por meio de uma interface padronizada e bem definida.

Dito isso, definimos que, um projeto de implantação de API envolve a criação

e disponibilização de um conjunto de interfaces de programação de aplicativos
(APIs) para uso por desenvolvedores de software e outros usuários. As APA seguir
estão as principais etapas envolvidas neste projeto de implantação de API:

i. Identificação do objetivo da API

Onde determinaremos o objetivo da API e as funcionalidades que ela deve

oferecer. Isso com a inclusão de acesso a dados de um sistema, integração com
outros serviços ou aplicativos, ou outras funcionalidades específicas.

ii. Escolha da tecnologia

Definimos em segunda estância o PHYTON como a tecnologia apropriada

para a implementação da API. Isso pode incluir uma variedade de opções, como
REST, SOAP, GraphQL, entre outras.

iii. Design da API

Projetamos a estrutura da API e a documentação necessária para descrever

suas funcionalidades e uso. Inclusão da definição dos endpoints e das operações
disponíveis na API.

iv. Implantação da API

Faremos a implantação da API em um ambiente de produção, garantindo que

ela esteja acessível e disponível para uso pelos usuários

v. Implementação da API
 Com a utilização da tecnologia escolhida e seguindo o design definido
anteriormente, podemos prosseguir para a incluir a criação de uma arquitetura para
a API e a implementação de recursos de segurança, como autenticação e
autorização.

vi. Testes e validação

Faremos os testes para garantir que a API esteja funcionando corretamente e

que as funcionalidades estejam disponíveis conforme definido na documentação.

vii. Monitoramento e manutenção:

Monitoramento do uso da API e sua a manutenção necessária para garantir a

continuidade do funcionando correto e atendendo às necessidades dos usuários.

Ao planejar e executar um projeto de implantação de API, foi importante

considerar os requisitos de segurança, desempenho, escalabilidade e usabilidade
para garantir que a API atenda às expectativas e necessidades dos usuários.

b. SISTEMA PROPOSTO
FIG. 1
FIG. 2

FIG. 3
 i. Diagrama de Caso Uso (Sistema proposto)
ii. DER (Diagrama Entidade Relacionamento)
iii. Dicionário de Dados

5. CRONOGRAMA

Definidos os prazos a tarefas a serem cumpridos, segue o cronograma

previsto para a finalização dos trabalhos. Importante salientar que todas as
atividades serão executadas em conjunto pela equipe da Inteligência Orgânica Corp.

CRONOGRAMA - IMPLANTAÇÃO DE API - TCC

DATA INICIO DATA FIM
DESENVOLVIMENTO
DA API 20/mai 15/set
DESENVOVIMENTO DO
BANCO 20/mai 31/ago
TESTES 01/set 30/set
ESTRATÉGIA DA API 30/set 01/out
VALIDAÇÃO 01/out 01/nov
ELABORAÇÃO DA
APRESENTAÇÃO 01/nov 30/nov
APRESENTAÇÃO 01/dez 01/dez

FIG. 4

6. DOCUMENTAÇÃO DA API – INCLUSA NO DESENVOLVIMENTO

 Nesta seção apresentamos a documentação da API, com o intuito de
fundamentar o projeto e também com o objetivo de demonstrar que a aplicação
consegue incorporar funcionalidades, agilizar rotinas e desenvolver recursos mais
inteligentes ao cliente, qual seja a empresa BMTECH E seus colaboradores e
clientes.

Considerando que a API, terá a integração com o Google calendar, como

anteriormente mencionado, no item 4. Passamos a demonstrar o código fonte de
mencionada integração:

7. FLUXOGRAMA
 O fluxograma abaixo ilustra as etapas, sequências e decisões de todo o processo e fluxo
de trabalho da API.

De forma que o Fluxograma é a representação gráfica que apresenta a sequência de um

trabalho, de forma analítica, caracterizando as operações, os responsáveis e/ou unidades
organizacionais envolvidas no processo, assim consideramos o que se segue:

8. ALGORITIMO
 Para utilizar esse código, basta colocar os dois arquivos em uma pasta e executar
o "quickstart.py".
Na primeira utilização ocorre o direcionamento para a tela de login do Google, que
solicitará a permissão de acesso para o app 'Organic Intelligence'.
Após a etapa de login será gerado um token na pasta dos arquivos e o ambiente
estará preparado e pronto para ser utilizado.
Assim que o status do ticket(que se encontra no Freshdesk) for alterado para “EM
ATENDIMENTO”, o Freshdesk dispara um webhook, com json, este último será
interpretado pelo script, desenvolvido em Python, com link para o banco dados
MySQL.
O ID_AGENTE, já previamente definido na automatização do Freshdesk, cria um
evento, usando regras de coloração, com título e final estimado do atendimento.

9. VERIFICAÇÃO DO PROCESSO DA API

10. MANUTENÇAO APÓS

11. TESTES

12. CONSIDERAÇÕES FINAIS

A implementação de uma API é um processo que pode trazer muitos benefícios

para uma empresa ou organização. No entanto, é importante lembrar que a
implantação de uma API pode não ser um processo fácil ou rápido.

Durante o processo de implementação, é importante ter um plano claro e

detalhado para garantir que todos os aspectos da API sejam cuidadosamente
considerados e implementados corretamente, como foi demonstrado e explicitado
durante o decorrer deste projeto.

Em resumo, este projeto pretende demonstrar que a implantação de uma API

pode trazer muitos benefícios para uma organização, mas é importante lembrar que
esse processo requer planejamento cuidadoso, habilidades e experiência
adequadas e um compromisso contínuo com o monitoramento e manutenção da
API.

REFERÊNCIAS BIBLIOGRÁFICAS

Disponível em <https://www.zendesk.com.br/blog/o-que-e-itil-e-para-que-serve/>
Acesso em 08 de Abril de 2023

Disponível<https://www.totvs.com/blog/negocios/analise-wot/#:~:text=A%20an
%C3%A1lise%20SWOT%20%C3%A9%20uma,melhor%20tomada%20de%20decis
%C3%A3o%20corporativa.> Acesso em 08 de Abril de 2023

Disponível em <https://www.researchgate.net/profile/Antonio-Santos-38/publication/
260771074_Corporate_governance_efficiency_productivity_and_performance/links/
551a9f0a0cf244e9a458a686/Corporate-governance-efficiency- productivity-and-
performance.pdf. . Acesso em 08 de Abril de 2023
APENDICE