|
||
---|---|---|
.. | ||
.husky | ||
Templates-test | ||
controllers | ||
data | ||
db | ||
errors | ||
middleware | ||
models | ||
routes | ||
services | ||
utils | ||
Procfile | ||
app.js | ||
env.example | ||
package-lock.json | ||
package.json | ||
readme.md | ||
swagger.yaml |
readme.md
Atenção
Para rodar a aplicação esteja na pasta backend. O .env deve estar dentro da pasta backend para rodar essa api.
Use o env.example
Nova Funcionalidade: Integração de Transcrição com HubSpot
Esta funcionalidade permite receber, processar e registrar transcrições de chamadas telefônicas diretamente no HubSpot, com associação automática ao contato e, se disponível, ao ticket da chamada.
Fluxo Geral
- Uma transcrição de chamada é recebida via endpoint REST (
/api/v1/crm/transcriptions
). - O sistema consulta o Redis para verificar se há um
ticketId
associado aocallerId
. - Se existir:
- A nota é associada ao contato e ao ticket correspondente no HubSpot.
- Se não existir:
- A nota é criada e associada apenas ao contato.
Exemplo de Requisição
Endpoint: POST /api/v1/crm/transcriptions
Body:
{
"callerId": "5511987654321",
"uniqueId": "chamada-001",
"transcription": {
"summary": "Cliente solicitou informações sobre o pedido.",
"client": "Gostaria de saber como está meu pedido.",
"agent": "Claro! Posso verificar agora."
},
"recordingUrl": "https://exemplo.com/gravação/audio.wav"
}
Verificação Prévia de Ticket
Antes de enviar a transcrição de uma chamada, o sistema realiza uma verificação para saber se já existe um ticket associado ao número de telefone (callerId
/ crmPhone
).
Endpoint:
GET /api/v1/crm/tickets/check-by-crmphone
Parâmetros de consulta (query params):
Parâmetro | Tipo | Obrigatório | Descrição |
---|---|---|---|
crmPhone | string | Sim | Número do telefone do cliente (E.164) |
Exemplo de Requisição:
GET /api/v1/crm/tickets/check-by-crmphone?crmPhone=5511997532324
Resposta (200 OK):
{
"hasTicket": true,
"ticketId": "25292628260"
}
Lógica de Uso
- Se
hasTicket
fortrue
, oticketId
será incluído no envio da transcrição. - Se
hasTicket
forfalse
, a transcrição não será enviada para essa api para o envio ao HubSpot.