Desafio - Desenvolvedor Pleno

O desafio consiste em realizar uma integração entre o chatbot e um serviço fictício, simulando
uma situação comum em empresas que utilizam a Suri em seus atendimentos.

Entregáveis:
● Ao final do desenvolvimento, ter um ambiente em que seja possível testar a integração
realizada
● Disponibilizar o código em um repositório Github público ou com acesso previamente
disponibilizado

Contexto:
Você é um desenvolvedor contratado por uma empresa provedora de internet para realizar uma
integração com o chatbot que ela utiliza, a Suri. A empresa necessita que, quando um contato
que fala através do WhatsApp solicita a segunda via de um boleto, o chatbot pergunte o CPF
de tal pessoa, enviando essa informação para um serviço que você irá implementar.
Este serviço deve verificar a validade deste CPF e, se válido, buscar em uma base de dados
pelo documento PDF e enviar de volta para o contato via WhatsApp. Caso haja algum erro no
CPF ou mesmo que o contato não encontre-se na base de dados, também deve ser enviada
uma mensagem informando tal erro.

APIs e Webhooks
Para realizar tal integração, deve-se utilizar APIs e webhooks disponibilizados pela Suri.
Seguem os links:
● Manual de integração
● Documentação completa do Postman

Ambiente:
Seguem abaixo o ambiente disponibilizado na plataforma de staging da Suri e uma breve
explicação dos conceitos básicos para fins de compreensão para a integração a ser realizada:
● Portal da Suri: https://portal-staging.chatbotmaker.io/
○ Realizar login com o email e senha enviados no e-mail com este documento
○ Neste portal, é possível ter acesso aos contatos que falaram com a Suri e gerenciar os
fluxos de conversação entre o bot e os contatos.
● Caso queira entender mais a fundo os conceitos da Suri, existem alguns links de explicação
para clientes recém implantados, que são a Central de ajuda, que possui uma maior
 variedade de assuntos e um resumo mais direcionado com os principais conceitos em
Entendendo a Suri
● No bot em questão, existe uma intenção de IA, ou seja, um fluxo que é disparado quando o
contato fala algumas frases pré-treinadas. Este fluxo solicita o CPF e redireciona para outra
intenção de IA de encerramento, como segue o print abaixo. A partir desse ponto, a
integração deve começar a acontecer:

● Para testar o chatbot, fale com ele através do WhatsApp no canal conectado, indo na página
Configurações > Geral > Aba Canais > Escolhendo o canal WhatsApp na lista e
clicando no botão Testar. Para facilitar, você sempre pode começar com um “oi” e seguir o
fluxo previamente configurado levando à intenção “Segunda via de boleto”. Sempre que
precisar, basta mandar um “oi” para começar do início do fluxo.
● A base de dados de onde será buscado o CPF e mapeamento do arquivo a ser enviado
pode ser qualquer uma de sua escolha, desde uma planilha no Google sheets a um banco
em nuvem como Firebase ou Azure Cosmos DB, contanto que também seja disponibilizado
o acesso para posterior validação da integração.
● O documento a ser enviado também pode ser qualquer um de sua escolha, até mesmo um
mockup como este.

Considerações finais
Não existe uma única forma ou uma mais correta de implementação desse desafio, existem

😉
algumas formas diferentes e igualmente válidas, sinta-se à vontade para fazer do seu jeito, mas
lembre-se de seguir as boas práticas