Visão Geral
Permita que seus agentes gerenciem operações de suporte ao cliente através do Zendesk. Crie e atualize tickets, gerencie usuários, monitore métricas de suporte e otimize seus fluxos de atendimento ao cliente com automação impulsionada por IA.Pré-requisitos
Antes de usar a integração com o Zendesk, certifique-se de que você possui:- Uma conta CrewAI AMP com uma assinatura ativa
- Uma conta Zendesk com permissões apropriadas de API
- Sua conta Zendesk conectada através da página de Integrações
Configurando a Integração Zendesk
1. Conecte sua Conta Zendesk
- Acesse CrewAI AMP Integrações
- Encontre Zendesk na seção Integrações de Autenticação
- Clique em Conectar e complete o fluxo OAuth
- Conceda as permissões necessárias para gerenciamento de tickets e usuários
- Copie seu Token Enterprise em Configurações de Integração
2. Instale o Pacote Necessário
3. Configuração de variável de ambiente
Para usar integrações com
Agent(apps=[]), você deve definir a variável de ambiente CREWAI_PLATFORM_INTEGRATION_TOKEN com seu Enterprise Token..env:
Ferramentas Disponíveis
Gerenciamento de Tickets
zendesk/create_ticket
zendesk/create_ticket
Descrição: Crie um novo ticket de suporte no Zendesk.Parâmetros:
ticketSubject(string, obrigatório): Assunto do ticket (ex.: “Socorro, minha impressora está pegando fogo!”)ticketDescription(string, obrigatório): Primeiro comentário que aparece no ticket (ex.: “A fumaça é muito colorida.”)requesterName(string, obrigatório): Nome do usuário solicitando suporte (ex.: “Jane Cliente”)requesterEmail(string, obrigatório): E-mail do solicitante do suporte (ex.: “jane@example.com”)assigneeId(string, opcional): ID do agente Zendesk atribuído ao ticket - Use as Configurações de Fluxo de Trabalho do Portal Connect para permitir a seleção do responsávelticketType(string, opcional): Tipo de ticket - Opções: problem, incident, question, taskticketPriority(string, opcional): Nível de prioridade - Opções: urgent, high, normal, lowticketStatus(string, opcional): Status do ticket - Opções: new, open, pending, hold, solved, closedticketDueAt(string, opcional): Data de vencimento para tickets do tipo tarefa (timestamp ISO 8601)ticketTags(string, opcional): Array de tags a aplicar (ex.:["enterprise", "outra_tag"])ticketExternalId(string, opcional): ID externo para vincular tickets a registros locaisticketCustomFields(object, opcional): Valores de campos personalizados em formato JSON
zendesk/update_ticket
zendesk/update_ticket
Descrição: Atualize um ticket de suporte existente no Zendesk.Parâmetros:
ticketId(string, obrigatório): ID do ticket a ser atualizado (ex.: “35436”)ticketSubject(string, opcional): Assunto atualizado do ticketrequesterName(string, obrigatório): Nome do solicitante deste ticketrequesterEmail(string, obrigatório): E-mail do solicitante deste ticketassigneeId(string, opcional): ID atualizado do responsável - Use as Configurações de Fluxo de Trabalho do Portal ConnectticketType(string, opcional): Tipo atualizado - Opções: problem, incident, question, taskticketPriority(string, opcional): Prioridade atualizada - Opções: urgent, high, normal, lowticketStatus(string, opcional): Status atualizado - Opções: new, open, pending, hold, solved, closedticketDueAt(string, opcional): Nova data de vencimento (timestamp ISO 8601)ticketTags(string, opcional): Array de tags atualizadasticketExternalId(string, opcional): Novo ID externoticketCustomFields(object, opcional): Valores atualizados dos campos personalizados
zendesk/get_ticket_by_id
zendesk/get_ticket_by_id
Descrição: Recupere um ticket específico pelo ID.Parâmetros:
ticketId(string, obrigatório): ID do ticket a ser recuperado (ex.: “35436”)
zendesk/add_comment_to_ticket
zendesk/add_comment_to_ticket
Descrição: Adicione um comentário ou nota interna a um ticket existente.Parâmetros:
ticketId(string, obrigatório): ID do ticket para adicionar o comentário (ex.: “35436”)commentBody(string, obrigatório): Mensagem do comentário (aceita texto simples ou HTML, ex.: “Obrigado pela sua ajuda!”)isInternalNote(boolean, opcional): Defina como verdadeiro para notas internas ao invés de respostas públicas (padrão é falso)isPublic(boolean, opcional): Verdadeiro para comentários públicos, falso para notas internas
zendesk/search_tickets
zendesk/search_tickets
Descrição: Busque tickets usando diversos filtros e critérios.Parâmetros:
ticketSubject(string, opcional): Filtrar pelo texto no assunto do ticketticketDescription(string, opcional): Filtrar por texto na descrição e comentários do ticketticketStatus(string, opcional): Filtrar por status - Opções: new, open, pending, hold, solved, closedticketType(string, opcional): Filtrar por tipo - Opções: problem, incident, question, task, no_typeticketPriority(string, opcional): Filtrar por prioridade - Opções: urgent, high, normal, low, no_priorityrequesterId(string, opcional): Filtrar por ID do solicitanteassigneeId(string, opcional): Filtrar pelo ID do agente responsávelrecipientEmail(string, opcional): Filtrar pelo e-mail do destinatário originalticketTags(string, opcional): Filtrar por tags do ticketticketExternalId(string, opcional): Filtrar por ID externocreatedDate(object, opcional): Filtrar por data de criação com operador (EQUALS, LESS_THAN_EQUALS, GREATER_THAN_EQUALS) e valorupdatedDate(object, opcional): Filtrar por data de atualização com operador e valordueDate(object, opcional): Filtrar por data de vencimento com operador e valorsort_by(string, opcional): Campo de ordenação - Opções: created_at, updated_at, priority, status, ticket_typesort_order(string, opcional): Direção da ordenação - Opções: asc, desc
Gerenciamento de Usuários
zendesk/create_user
zendesk/create_user
Descrição: Crie um novo usuário no Zendesk.Parâmetros:
name(string, obrigatório): Nome completo do usuárioemail(string, opcional): E-mail do usuário (ex.: “jane@example.com”)phone(string, opcional): Telefone do usuáriorole(string, opcional): Papel do usuário - Opções: admin, agent, end-userexternalId(string, opcional): Identificador único de outro sistemadetails(string, opcional): Detalhes adicionais do usuárionotes(string, opcional): Notas internas sobre o usuário
zendesk/update_user
zendesk/update_user
Descrição: Atualize informações de um usuário existente.Parâmetros:
userId(string, obrigatório): ID do usuário a ser atualizadoname(string, opcional): Nome atualizado do usuárioemail(string, opcional): Novo e-mail (adicionado como e-mail secundário na atualização)phone(string, opcional): Novo telefonerole(string, opcional): Novo papel - Opções: admin, agent, end-userexternalId(string, opcional): Novo ID externodetails(string, opcional): Novos detalhes do usuárionotes(string, opcional): Novas notas internas
zendesk/get_user_by_id
zendesk/get_user_by_id
Descrição: Recupere um usuário específico pelo ID.Parâmetros:
userId(string, obrigatório): ID do usuário a ser recuperado
zendesk/search_users
zendesk/search_users
Descrição: Busque usuários utilizando vários critérios.Parâmetros:
name(string, opcional): Filtrar por nome do usuárioemail(string, opcional): Filtrar por e-mail do usuário (ex.: “jane@example.com”)role(string, opcional): Filtrar por papel - Opções: admin, agent, end-userexternalId(string, opcional): Filtrar por ID externosort_by(string, opcional): Campo de ordenação - Opções: created_at, updated_atsort_order(string, opcional): Direção de ordenação - Opções: asc, desc
Ferramentas Administrativas
zendesk/get_ticket_fields
zendesk/get_ticket_fields
Descrição: Recupere todos os campos padrão e personalizados disponíveis para tickets.Parâmetros:
paginationParameters(object, opcional): Configurações de paginaçãopageCursor(string, opcional): Cursor de página para paginação
zendesk/get_ticket_audits
zendesk/get_ticket_audits
Descrição: Obtenha registros de auditoria (histórico somente leitura) dos tickets.Parâmetros:
ticketId(string, opcional): Obtenha auditorias para um ticket específico (se vazio, recupera auditorias de todos os tickets não arquivados, ex.: “1234”)paginationParameters(object, opcional): Configurações de paginaçãopageCursor(string, opcional): Cursor de página para paginação
Campos Personalizados
Campos personalizados permitem armazenar informações adicionais específicas para sua organização:Níveis de Prioridade dos Tickets
Compreendendo os níveis de prioridade:- urgent - Questões críticas que exigem atenção imediata
- high - Questões importantes que devem ser tratadas rapidamente
- normal - Prioridade padrão para a maioria dos tickets
- low - Questões menores que podem ser tratadas quando conveniente
Fluxo de Status dos Tickets
Progresso padrão de status dos tickets:- new - Recém-criado, ainda não atribuído
- open - Em andamento
- pending - Aguardando resposta do cliente ou ação externa
- hold - Pausa temporária
- solved - Problema resolvido, aguardando confirmação do cliente
- closed - Ticket finalizado e fechado
