​
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:

​
Ferramentas Disponíveis

​
Gerenciamento de Tickets

​
Gerenciamento de Usuários

​
Ferramentas Administrativas

​
Campos Personalizados

Campos personalizados permitem armazenar informações adicionais específicas para sua organização:

[
  { "id": 27642, "value": "745" },
  { "id": 27648, "value": "yes" }
]

​
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

​
Exemplos de Uso

​
Configuração Básica de Agente Zendesk

from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

# Obtenha as ferramentas enterprise (as ferramentas Zendesk serão incluídas)
enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)

# Crie um agente com capacidades Zendesk
zendesk_agent = Agent(
    role="Gerente de Suporte",
    goal="Gerenciar tickets de suporte ao cliente e oferecer excelente atendimento",
    backstory="Um assistente de IA especializado em operações de suporte ao cliente e gerenciamento de tickets.",
    tools=[enterprise_tools]
)

# Tarefa para criar um novo ticket de suporte
create_ticket_task = Task(
    description="Crie um ticket de suporte de alta prioridade para John Smith que não consegue acessar sua conta após redefinir a senha",
    agent=zendesk_agent,
    expected_output="Ticket de suporte criado com sucesso com o ID do ticket"
)

# Execute a tarefa
crew = Crew(
    agents=[zendesk_agent],
    tasks=[create_ticket_task]
)

crew.kickoff()

​
Filtrando Ferramentas Zendesk Específicas

from crewai_tools import CrewaiEnterpriseTools

# Obtenha apenas ferramentas Zendesk específicas
enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token",
    actions_list=["zendesk_create_ticket", "zendesk_update_ticket", "zendesk_add_comment_to_ticket"]
)

support_agent = Agent(
    role="Agente de Suporte ao Cliente",
    goal="Atender consultas de clientes e resolver issues de suporte de forma eficiente",
    backstory="Um agente de suporte experiente que se especializa em resolução de tickets e comunicação com clientes.",
    tools=enterprise_tools
)

# Tarefa para gerenciar o fluxo de suporte
support_task = Task(
    description="Crie um ticket para problemas de login, adicione comentários de troubleshooting e atualize o status para resolvido",
    agent=support_agent,
    expected_output="Ticket de suporte gerenciado através de todo o fluxo de resolução"
)

crew = Crew(
    agents=[support_agent],
    tasks=[support_task]
)

crew.kickoff()

​
Gerenciamento Avançado de Tickets

from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)

ticket_manager = Agent(
    role="Gerente de Tickets",
    goal="Gerenciar fluxos de tickets de suporte e garantir resolução tempestiva",
    backstory="Um assistente de IA que se especializa em triagem de tickets de suporte e otimização de fluxos de trabalho.",
    tools=[enterprise_tools]
)

# Tarefa para gerenciar o ciclo de vida do ticket
ticket_workflow = Task(
    description="""
    1. Crie um novo ticket de suporte para problemas de acesso à conta
    2. Adicione notas internas com as etapas de troubleshooting
    3. Atualize a prioridade do ticket de acordo com o nível do cliente
    4. Adicione comentários de resolução e feche o ticket
    """,
    agent=ticket_manager,
    expected_output="Ciclo de vida completo do ticket gerenciado da criação à resolução"
)

crew = Crew(
    agents=[ticket_manager],
    tasks=[ticket_workflow]
)

crew.kickoff()

​
Análise e Relatórios de Suporte

from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)

support_analyst = Agent(
    role="Analista de Suporte",
    goal="Analisar métricas de suporte e gerar insights para desempenho da equipe",
    backstory="Um IA analítico que se destaca na extração de insights a partir de dados de suporte e padrões de tickets.",
    tools=[enterprise_tools]
)

# Tarefa complexa envolvendo análise e geração de relatórios
analytics_task = Task(
    description="""
    1. Busque todos os tickets abertos nos últimos 30 dias
    2. Analise tempos de resolução dos tickets e satisfação do cliente
    3. Identifique problemas comuns e padrões de suporte
    4. Gere relatório semanal de desempenho do suporte
    """,
    agent=support_analyst,
    expected_output="Relatório analítico abrangente de suporte com insights de desempenho e recomendações"
)

crew = Crew(
    agents=[support_analyst],
    tasks=[analytics_task]
)

crew.kickoff()