Integrações, API e webhooks
O Luradesk oferece uma API REST e webhooks para que outros sistemas criem tickets e reajam a eventos do atendimento. Esta página separa o que já está disponível do que está planejado.
Arquitetura
Cada empresa no Luradesk tem o seu próprio banco de dados. Um token de API pertence a uma única empresa, e o servidor identifica a empresa pelo token antes de abrir qualquer dado dela. Um token de uma empresa nunca consegue ler tickets de outra.
Disponível hoje
| Integração | O que faz | Planos |
|---|---|---|
| API REST | Cria, lista e consulta tickets via HTTPS com token do tipo bearer | Professional, Business |
| Webhooks | Envia notificações HTTP POST assinadas quando tickets são criados ou atualizados | Professional, Business |
| Notificações por e-mail | Avisa o solicitante por e-mail quando um agente responde | Starter em diante |
API REST
Os tokens são criados por um administrador em Configurações → Tokens de API. Só o hash de cada token é armazenado, e os tokens podem ser revogados a qualquer momento.
GET /api/v1/tickets lista tickets (filtros: status, page)
POST /api/v1/tickets cria um ticket
GET /api/v1/tickets/{number} consulta um ticket e suas mensagens públicas
As requisições usam Authorization: Bearer <token> e corpo em JSON. Há limites de taxa.
Webhooks
Um webhook envia um JSON para o seu endpoint HTTPS em eventos como ticket.created e ticket.updated. Cada requisição traz o cabeçalho X-Luradesk-Signature com um HMAC-SHA256 do corpo, para que o seu sistema confirme que ela veio do Luradesk. Entregas que falham são reenviadas com intervalos crescentes.
Notificações por e-mail
O solicitante recebe um e-mail quando a equipe responde publicamente ao seu ticket. Notas internas nunca geram e-mails para solicitantes.
Planejado
Estas integrações estão no roadmap e ainda não estão disponíveis:
- E-mail para ticket: criar tickets a partir de mensagens enviadas a um endereço de suporte.
- WhatsApp: receber e responder solicitações pelo WhatsApp dentro do ticket. Os custos de mensagens poderão ser cobrados à parte.
- Assistência com IA: sugestões de resposta, resumos e classificação. O consumo poderá ser cobrado à parte.
- Aplicativos móveis.
- Login único (SSO).
Se a integração de que você precisa não está na lista, fale com a gente. Os pedidos de equipes como a sua orientam o roadmap.
Reúna todas as solicitações de suporte em um só lugar
Crie o seu help desk no plano Free, convide a sua equipe e abra o primeiro ticket em poucos minutos.