Atendimento
Freshdesk no seu produto e nos seus agentes de IA, por uma API
O toolkit do Freshdesk cobre tickets e suas conversas, campos de ticket, contatos e busca de empresas. Seu produto ou agente de IA os chama pelo Connect, que guarda as credenciais do cliente e registra cada execução, sem você construir a integração.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/freshdesk_create_ticket/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"requester_id": 1
}
}Como funciona
Do cliente conectado à primeira chamada no Freshdesk.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Freshdesk. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Freshdesk.
Abra tickets pelo seu produto
Um SaaS cria um ticket no Freshdesk quando um usuário relata um problema, identificando o solicitante pelo e-mail para que um novo contato seja criado se preciso.
Copiloto de suporte para agentes
Um agente de IA busca tickets por status ou prioridade, lê a conversa e publica uma nota privada ou uma resposta ao solicitante.
Contatos sempre em sincronia
Um CRM ou ferramenta de cobrança cria e atualiza contatos no Freshdesk e os vincula a empresas encontradas pelo nome.
Tools
13 tools do Freshdesk
- Listar ticketsGETLista tickets, os mais recentes primeiro por padrão. Sem updated_since voltam só os tickets criados nos últimos 30 dias, e spam ou excluídos só vêm com filtro.
- Buscar ticketsGETBusca tickets com uma query de filtro, por exemplo por status, prioridade, agente, grupo, tag ou campo personalizado. Devolve total e results, 30 tickets por página.
- Obter ticketGETDevolve um ticket com status, priority, requester_id, responder_id, group_id, tags, custom_fields e description.
- Criar ticketPOSTCria um ticket. Identifique o solicitante com requester_id, email, phone ou unique_external_id; um email ou phone ainda não existente no Freshdesk cria o contato.
- Atualizar ticketPUTAtualiza um ticket: envie só os campos a mudar, e tags como a lista completa que o ticket deve manter. Status 4 resolve e 5 fecha o ticket.
- Listar conversas do ticketGETLista as respostas e notas de um ticket, com body (HTML), body_text, private, incoming, user_id e source (0 resposta, 2 nota). As páginas são numeradas a partir de 1.
- Criar resposta no ticketPOSTResponde ao solicitante de um ticket. O Freshdesk envia a resposta por e-mail ao solicitante, então ela fica visível ao cliente.
- Criar nota no ticketPOSTAdiciona uma nota a um ticket. As notas são privadas por padrão, visíveis só aos agentes; com private false o solicitante também a vê.
- Listar campos de ticketGETLista os campos de ticket do helpdesk com suas opções: ids de agentes no campo de agente, ids de grupos no campo de grupo, ids de produtos e valores de status.
- Listar contatosGETLista contatos, os clientes que abrem tickets, com id, name, email, phone, mobile, company_id, tags e custom_fields. Os filtros se combinam.
Usuário e senha
O cliente informa as credenciais do app numa tela do Connect, ou o seu sistema as envia por POST /api/customer-toolkits, sem tela.
Na conexão, o cliente informa também {domain}: o endereço da conta dele na API do app.
Perguntas sobre o toolkit do Freshdesk
Preciso implementar a API do Freshdesk?
Não. O Connect já traz 13 tools do Freshdesk descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Freshdesk?
Pelo modo que o toolkit aceita: Usuário e senha. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Toolkits da mesma categoria
Ver os 100 toolkitsVeja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
