O melhor portal de Marketing e Vendas para a sua empresa
Qual a melhor forma de cobrar os consumidores? Saiba neste artigo como realizar a cobrança de forma empática e automatizada
min de leitura
A pandemia trouxe resultados negativos no setor financeiro, em uma pesquisa realizada em dezembro pela Confederação Nacional do Comércio de Bens, Serviços e Turismo, 66,3% dos consumidores estavam endividados. Por conta desses resultados, as organizações acabam por entrar em contato com o consumidor para realizar a cobrança dos valores devidos. Neste artigo, saiba como cobrar de forma prática e escalável.
Aqui você encontrará:
1. Primeiro Passo
2. Text to Speech
3. Como funcionam as chamadas para esta API
4. Criando a aplicação Node.js
A pandemia trouxe resultados negativos no setor financeiro, em uma pesquisa realizada em dezembro pela Confederação Nacional do Comércio de Bens, Serviços e Turismo (CNC), 66,3% dos consumidores estavam endividados.
Em janeiro, esse número cresceu, 66,5% da população está endividada. Estes números são permeabilizados por diversos fatores como a alta na taxa de desemprego, falta de conhecimento financeiro, entre outros.
Por conta desses resultados, as organizações acabam por entrar em contato com o consumidor para realizar a cobrança dos valores devidos. Entretanto, a forma como a cobrança é realizada não alcança o objetivo estipulado.
Isso porque a forma como o contato é efetivado muitas vezes acaba por constranger o consumidor ou a insistência e diversas ligações seguidas fazem com que a pessoa desista de atender o telefone e a organização acaba por não conseguir conversar sobre a situação.
Por isso é necessário que as organizações saibam fazer uma cobrança amigável e que conte com técnicas humanizadas como saber ouvir, entender a situação, oferecer negociações e cobrar de forma singela.
Mas, antes de chegar ao ponto de cobrar o cliente, podemos contar com o apoio da tecnologia para alertar sobre atrasos de pagamento de outra forma. Dito isso, a organização pode utilizar o método de múltiplos canais como a utilização de SMS, e-mails e notificação por voz são uma boa pedida.
Tudo deve ser feito de acordo com o tempo de inadimplência do cliente. Por exemplo, uma dica é enviar lembrete cerca de cinco dias antes do vencimento de um pagamento, depois enviar no dia do vencimento e depois após o vencimento.
Para todos esses meios, é interessante que a organização trabalhe com a automatização de atendimento. Quando automatizamos processos podemos ter diversos benefícios como redução de custo, otimização de tempo, padronização de processos e entre outros.
Neste tutorial, iremos desenvolver uma aplicação com um banco de dados que armazena dívidas com a data de vencimento do pagamento dessa dívida e informações do devedor como número de celular e nome. Com essas informações no banco de dados, a aplicação será capaz de enviar lembretes por torpedos de voz de acordo com alguns períodos em relação à data de vencimento.
Será enviado um torpedo seguindo esses períodos: 5 dias antes do vencimento, no dia do vencimento, 3 dias depois, 15 dias depois e 30 dias depois.
Para criar a conta de acesso à API da Zenvia, basta entrar no site da Total Voice, preencher as informações e clicar em “CRIAR“.
Após criar a conta, é preciso confirmar o número de celular e o endereço de e-mail para ter acesso ao painel. Após confirmar suas informações é possível acessar o painel e adquirir o Access Token para se autenticar nas requisições à API, você precisará desta informação mais tarde.
Iremos utilizar o recurso TTS (Text To Speech) e as informações sobre os endpoints da API estão disponíveis na documentação.
A funcionalidade de TTS (Text to Speech) da API de voz da Zenvia nos permite enviar uma uma mensagem de texto e ela transforma o texto em áudio falado e reproduz em uma ligação telefônica para o número indicado na chamada. Assim, quando o número destino atende o mesmo irá escutar uma voz falando a mensagem escrita.
Também podem ser enviadas algumas opções adicionais, tais como aguardar uma resposta do usuário, gravar o áudio da ligação ou colocar um número bina que aparecerá no momento da ligação. Para fins didáticos, vamos utilizar apenas o básico do recurso.
O acesso à API está disponível em Node.js através de uma dependência chamada totalvoice-node, porém ela não tem suporte a typescript e para fins didáticos e para que este tutorial possa ajudar as pessoas que não utilizam Node.js, vamos fazer as chamadas através de requisições http (Hypertext Transfer Protocol).
A API recebe as requisições através do URL (Uniform Resource Locator) base https://api2.totalvoice.com.br e vamos utilizar o endpoint /tts para acessar o recurso Text to Speech.
Para que a API reconheça o que queremos e quem está solicitando, precisamos enviar uma requisição POST com os seguintes headers:
Content-Type: application/json
access-token: <SEU_ACCESS_TOKEN_DISPONÍVEL_NO_PAINEL>E um JSON no corpo da requisição neste modelo:
{
"numero_destino": "11999999999",
"mensagem": "Mensagem que deseja ser dita no torpedo de voz."
}1- Instale o Node.js no seu computador (de preferência a versão LTS);
1.1- opcional – Instale o yarn. O Node.js possui um gerenciador de pacotes padrão chamado npm (Node Package Manager), porém existe um gerenciador diferente chamado yarn. No restante deste artigo, haverão as opções de instalação para ambos gerenciadores de pacote como no passo a seguir.
2- Inicie o projeto criando o package.json com o seguinte comando no terminal:
npm init -y
yarn init -y3- Instale o ts-node, ts-node-dev e o typescript como dependências de desenvolvimento:
npm i ts-node ts-node-dev typescript -D
yarn add ts-node ts-node-dev typescript -D3.1 – Instale o arquivo de configuração do typescript:
npx typescript --init4- Crie um arquivo src/server.ts para testarmos a aplicação:
console.log('Hello World!')5- Abra o arquivo package.json e insira o script para iniciar o servidor assim como na área grifada em cinza:
{
"name": "zenvia-voice-default",
"version": "1.0.0",
"main": "index.js",
"license": "MIT",
"scripts": {
"dev": "ts-node-dev --transpile-only --ignore-watch node_modules --respawn src/server.ts"
},
"devDependencies": {
"ts-node": "^9.1.1",
"ts-node-d": "^1.1.1",
"typescript": "^4.1.3"
}
}5.1- Sempre que você quiser executar a aplicação basta executar no terminal:
npm run dev
yarn dev6- Vamos começar criando o nosso banco que dados que armazenará as informações dos inadimplentes. Para fins didáticos, vamos utilizar o banco de dados SQLite, pois ele não necessita de instalação e o banco fica salvo em apenas um arquivo. Para manusear o banco de dados vamos utilizar o Prisma, ORM (Object Relational Mapper) para Node.js e Typescript muito útil e prático, permitindo que alteremos o banco de dados mudando apenas uma linha de código. Instale as dependências do prisma @prisma/cli e @prisma/client e inicialize o prisma:
npm install @prisma/cli @prisma/client
yarn add @prisma/cli @prisma/client && npx prisma initA inicialização do prisma irá gerar um arquivo prisma/schema.prisma é nele que iremos esquematizar nosso banco de dados.
7- Arquitete o banco de dados no arquivo prisma/schema.prisma:
datasource db {
provider = "sqlite"
url = "file:./dev.db"
}
generator client {
provider = "prisma-client-js"
}
model Pessoa {
id Int @id @default(autoincrement())
nome String
celular String
Divida Divida[]
}
model Divida {
id Int @id @default(autoincrement())
dataVencimento DateTime
dividendo Pessoa @relation(fields: [dividendoId], references: [id])
dividendoId Int
valor Float
} 8- Execute a criação do banco de dados:
npx prisma migrate dev --name init --preview-featureAssim, o arquivo do seu banco de dados será criado prisma/dev.db.
9- Para testar a aplicação, crie o arquivo prisma/seed.ts para popular o banco de dados, troque os números de celular pelo seu para receber os torpedos de voz e troque as datas das dívidas para que esteja de acordo com os períodos explicados no início do tutorial:
import { PrismaClient } from '@prisma/client'
const prisma = new PrismaClient()
const main = async () => {
// Inserção das pessoas
await prisma.pessoa.create({ data: { nome: 'Pessoa 1', celular: '+11999999999' }})
await prisma.pessoa.create({ data: { nome: 'Pessoa 2', celular: '+11999999999' }})
await prisma.pessoa.create({ data: { nome: 'Pessoa 3', celular: '+11999999999' }})
await prisma.pessoa.create({ data: { nome: 'Pessoa 4', celular: '+11999999999' }})
console.log('Pessoas criadas.')
// Inserção das dividas
await prisma.divida.create({data: { valor: 251.59, dataVencimento: '2021-02-01T00:00:00Z', dividendoId: 1}})
await prisma.divida.create({data: { valor: 2051.49, dataVencimento: '2021-02-16T00:00:00Z', dividendoId: 2}})
await prisma.divida.create({data: { valor: 521.97, dataVencimento: '2021-02-28T00:00:00Z', dividendoId: 3}})
await prisma.divida.create({data: { valor: 151.58, dataVencimento: '2021-03-03T00:00:00Z', dividendoId: 4}})
await prisma.divida.create({data: { valor: 2311.19, dataVencimento: '2021-03-08T00:00:00Z', dividendoId: 1}})
console.log('Dívidas criadas.')
}
main().catch((e) => console.error(e)) 10- Adicione o script seed no arquivo package.json:
{
"name": "zenvia-voice-default",
"version": "1.0.0",
"main": "index.js",
"license": "MIT",
"scripts": {
"dev": "ts-node-dev --transpile-only --ignore-watch node_modules --respawn src/server.ts",
"seed": "ts-node prisma/seed.ts"
},
"devDependencies": {
"ts-node": "^9.1.1",
"ts-node-dev": "^1.1.6",
"typescript": "^4.2.2"
},
"dependencies": {
"@prisma/cli": "^2.18.0",
"@prisma/client": "^2.18.0",
}
}11- Execute o script seed:
npm run seed
yarn seedAgora, com o banco de dados criado e populado, podemos começar a desenvolver a lógica da nossa aplicação.
12- Instale o node-cron e o dotenv para criarmos nossa aplicação:
npm i node-cron dotenv && npm i --save-dev @types/node-cron
yarn add node-cron dotenv && yarn add @types/node-cron-D13- Instale o Axios para realizarmos as requisições http:
npm i axios
yarn add axios14- Vamos começar criando o arquivo de configuração do Axios para chamarmos a API de voz da Zenvia services/api.ts:
import axios from 'axios'
export const api= axios.create({
baseURL: 'https://api2.totalvoice.com.br',
})15- Crie um arquivo chamado .env, nele conterá seu token de acesso em uma variável de ambiente, coloque seu token logo após o sinal de =:
VOICE_TOKEN=16- Volte para o arquivo src/server.ts, ele será o nosso arquivo de configuração do servidor para criarmos nossa API:
import cron from 'node-cron'
import { checkAndSendSMSUseCase } from './UseCases/CheckAndSendSMS/index'
// A cada hora será feita uma checagem no banco de dados se há a necessidade de enviar SMS de voz, caso tiver, será enviado
cron.schedule('* * * *', () => {
checkAndSendSMSUseCase.execute()
}) O checkAndSendSMSUseCase será criado a seguir, mas antes, vamos criar alguns arquivos que ele depende.
17- Crie a função getDatetimes para gerar um array com as datas relativas a aqueles períodos do início do tutorial (-30, -15, -3, 0, 5). Crie o arquivo utils/getDatetime:
export const getDatetimes = () => {
// Retorna um array coms as datas
return [-30, -15, -3, 0, 5].map((days) => {
// Pega o dia de hoje
const date = new Date()
// Soma com o período em questão
date.setDate(date.getDate() + days)
// Transforma do jeito que o Brasil vê as datas e divide pelo espaço
const generatedDatetime = date.toLocaleString('pt-BR').split(' ')
// Captura a data e o horário atual
const finalDate = generatedDatetime[0].split('/')
// Retorna a data organizada no padrão do banco de dados
return `${finalDate[2]}-${finalDate[1]}-${finalDate[0]}T00:00:00Z`
})
} 18- Crie a função getMessage que irá gerar as mensagens de acordo com cada período, levando como parâmetros o nome do dividendo guardado no banco de dados, o valor da dívida e um índice de controle referente a quantos dias de distância do vencimento (0-> -30, 1-> -15, 2-> -3, 3-> 0,4-> 5). Crie o arquivo utils/getMessage.ts:
const transformMoney = (value: number) => {
const money = value.toString().split('.')
return `${money[0]} reais e ${money[1]} centavos`
}
const valueWithInterest = (value: number, interest: number) => {
return value + value * interest
}
export const getMessage = (name: string, value: number, index: number): string => {
switch (index) {
case 0:
return `Olá ${name}, sou da Bo Boletos e estou aqui pra te informar que já fazem que o prazo de pagamento da sua dívida de ${transformMoney(
valueWithInterest(value, 0.05)
)} com nós venceu há 30 dias, logo foi adicionado 5% de juros. Estamos abertos a negociação, se tiver interesse entre em contato: 0800 0001. Obrigado pela atenção.`
case 1:
return `Olá ${name}, sou da Bo Boletos e estou aqui pra te informar que seu débito venceu há 15 dias, aproveite para quitar com juros baixo antes que ele aumente. Obrigado pela atenção.`
case 2:
return `Olá ${name}, sou da Bo Boletos e estou aqui pra te informar que seu boleto de ${transformMoney(
value
)} venceu há 3 dias, caso se esqueceu ainda pode pagar para evitar problemas futuros. Obrigado pela atenção.`
case 3:
return `Olá ${name}, sou da Bo Boletos e estou aqui pra te informar que seu boleto de ${transformMoney(
value
)} vence hoje, não esqueça de quitá-lo para evitar juros. Caso já tenha pago, desconsidere esta mensagem. Obrigado pela atenção.`
case 4:
return `Olá ${name}, sou da Bo Boletos e estou aqui pra te avisar que você tem mais 5 dias para que o pagamento da sua dívida de ${transformMoney(
value
)} vença. Quite-a em dia para evitar juros. Caso já tenha pago, desconsidere esta mensagem. Obrigado pela atenção.`
default:
return ''
}
} 19- Crie o caso de uso SendVoiceSMSUseCase que que será responsável por efetuar a chamada à API de voz da Zenvia, levando como parâmetros o número do destinatário e a mensagem em si que será convertida em voz pela API. Crie os arquivos src/UseCases/SendVoiceSMS/SendSMSUseCase.ts e src/UseCases/SendVoiceSMS/index.ts com os respectivos códigos:
import { api } from '../../services/api'
import { config } from 'dotenv'
config() // Inicialização do dotenv
export class SendVoiceSMSUseCase {
execute(numero_destino: string, mensagem: string) {
api
.post(
'/tts',
{
numero_destino,
mensagem,
},
{
headers: {
'Content-Type': 'application/json',
'access-token': `${process.env.VOICE_TOKEN}`,
},
}
)
.then((res: any) => {
const { sucesso } = res.data
// Verificação de êxito
if (sucesso === true) {
console.log('Sucesso ao ligar para ' + numero_destino)
} else {
console.log('Erro ao ligar para ' + numero_destino)
}
})
.catch((error: any) => {
// Caso não seja possível chamar a API de voz, exibe um status de erro no console
console.log('Error:', error)
// Retorna uma resposta de erro para quem chamou nossa API
console.log('Erro desconhecido ao chamar a API de voz.')
})
}
} import { SendVoiceSMSUseCase } from './SendSMSUseCase'
export const sendVoiceSMSUseCase = new SendVoiceSMSUseCase() 20- Agora, crie o caso de uso FindDebtByDates que será responsável por procurar no banco de dados as dívidas a partir de um array de datas e devolver um array com as dívidas encontradas e recebera esse array como parâmetro. Crie os arquivos src/UseCases/FindDebtByDates/FindDebtByDatesUseCase.ts e src/UseCases/FindDebtByDates/index.ts com os respectivos códigos:
import { PrismaClient } from '@prisma/client'
const prisma = new PrismaClient()
export class FindDebtByDatesUseCase {
execute(datetimes: string[]) {
// Busca no banco de dados todas as dívidas de acordo com as datas do array
const found = datetimes.map((datetime) =>
prisma.divida.findMany({
where: { dataVencimento: datetime },
select: { dividendo: true, valor: true },
})
)
// Retorna as informações
return Promise.all(found).then(function (results) {
return results
})
}
} import { FindDebtByDatesUseCase } from './FindDebtByDatesUseCase'
export const findDebtByDatesUseCase = new FindDebtByDatesUseCase() 21- Agora, crie o caso de uso CheckAndSendSMS que chamamos lá no início no src/server.ts e será responsável por fazer a intermediação dos dois casos de uso criados anteriormente. Crie os arquivos src/UseCases/CheckAndSendSMS/CheckAndSendSMSUseCase.ts e src/UseCases/CheckAndSendSMS/index.ts com os respectivos códigos:
import { getMessage } from './../../utils/getMessage'
import { sendVoiceSMSUseCase } from './../SendVoiceSMS/index'
import { getDatetimes } from './../../utils/getDatetimes'
import { findDebtByDatesUseCase } from './../FindDebtByDates/index'
export class CheckAndSendSMSUseCase {
async execute() {
// Gera um array com as datas dos respectivos torpedos de voz que precisam ser enviados
const datetimes = getDatetimes()
// Busca no banco de dados as dívidas com essas datas e retorna um array
const debts = await findDebtByDatesUseCase.execute(datetimes)
// Efetua as chamadas para as pessoas com dívidas
debts.forEach((debtsArray, index) => {
debtsArray.forEach(async (debt) => {
await sendVoiceSMSUseCase.execute(
debt.dividendo.celular,
getMessage(debt.dividendo.nome, debt.valor, index)
)
})
})
}
} import { CheckAndSendSMSUseCase } from './CheckAndSendSMSUseCase'
export const checkAndSendSMSUseCase = new CheckAndSendSMSUseCase() Sua aplicação está pronta. Para testá-la, basta executar o script dev sevocê já cumpriu com todos os passos anteriores. Após a inicialização da aplicação ela irá fazer a checagem se há a necessidade de enviar um torpedo de voz, se houver ela irá enviar. Depois disso a cada uma hora essa checagem é feita novamente e isso é controlado pelo node-cron e os casos de uso que criamos neste tutorial.
Essa é uma pequena demonstração do que você pode fazer com a API de voz da Zenvia e a sua imaginação é o limite.
Lembre-se que para usar a API de Voz Zenvia, após criar sua conta na plataforma, é preciso utilizar o access-token e informar o número de destino. Com isso o usuário pode fazer sua primeira ligação.
Você pode acessar o projeto final da aplicação produzida neste tutorial no nosso repositório do github.
Amplie sua estratégia de comunicação! Crie sua conta agora e comece a testar a API de Voz Zenvia.
