Como podemos ajudar?

API de tickets
3 min
Criado por Leonora Alves em 17/06/2025 16:15
Atualizado por Leonora Alves em 07/10/2025 12:22

A API de tickets do Zenvia Customer Cloud permite integrar seus sistemas externos à plataforma, automatizando a criação, edição e consulta de tickets de suporte, sem necessidade de acesso manual.

Neste artigo, conheça os principais conceitos, como funciona a estrutura dos tickets e como utilizar a API.

📄 Documentação técnica da API
Para detalhes de endpoints, parâmetros, exemplos de requisição e resposta, acesse: Zenvia OpenAPI - Tickets

Funcionalidades disponíveis

Com a API de tickets, você pode:

  • Criar tickets automaticamente: Registre novos atendimentos a partir de sistemas externos (como formulários, ERPs ou e-mails de suporte).
  • Atualizar tickets existentes: Modifique informações, adicione comentários ou altere status.
  • Consultar tickets: Obtenha informações sobre tickets já existentes, incluindo status, datas, canal de origem, agente responsável e outros detalhes.

💡 Dica: Use essa API para integrar tickets com seus próprios sistemas, dashboards, CRMs ou ferramentas internas de análise.

Autenticação

O acesso à API é feito por meio de um Token de autenticação, garantindo segurança nas consultas.
Se você ainda não tem um token, confira nosso artigo: Tokens e webhooks para usar nas APIs.

Principais conceitos

Antes de começar a usar a API de tickets, é importante entender alguns conceitos que fazem parte do funcionamento dos tickets no Zenvia Customer Cloud.

Conceito

Descrição

Ticket

Registro de um atendimento, com dados como cliente, canal, status e interações.

ID do Ticket

Identificador único do ticket, utilizado para buscar detalhes específicos via API.

Status

Fase em que o ticket se encontra (Aberto, Em andamento, Resolvido, etc.).

Canal

Origem da interação (Chat, E-mail ou Agente).

Atributos

Dados associados ao ticket, como nome do cliente, categoria, prioridade e agente.

Quando utilizar essa API?

  • Para abrir tickets automaticamente a partir de integrações externas.
  • Para atualizar tickets em andamento sem precisar acessar a plataforma manualmente.
  • Para consultar tickets existentes e integrar essas informações aos seus próprios sistemas.
  • Para monitorar métricas operacionais e gerar relatórios personalizados de atendimento.