> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # ServiceTitan Sua recepcionista pode pesquisar quem liga no ServiceTitan, enviar novos trabalhos como um agendamento para sua equipe de atendimento revisar e informar clientes existentes sobre o próximo horário agendado. A API do ServiceTitan troca um ID e um segredo de cliente por tokens de curta duração e também exige uma chave de app, o que as ferramentas de webhook não conseguem fazer, então o Reception se conecta pelo [Zapier](/docs/pt/reception-ai/integrations/zapier). ## Antes de começar A integração do ServiceTitan com o Zapier está em beta aberto, e o ServiceTitan a fornece como está. Para conectá-la: 1. Um administrador do ServiceTitan envia o formulário de registro do Zapier do ServiceTitan. O ServiceTitan entrará em contato com você para informar os próximos passos. 2. No ServiceTitan, acesse **Settings** → **Integrations** → **API Application Access**, selecione **Connect New App** e escolha **Zapier 3.0.X**. 3. Revise os escopos, escolha uma opção de **Booking Provider** e selecione **Allow Access**. 4. Gere um segredo de cliente e copie-o, junto com o ID de cliente e o ID do seu tenant. > **Warning** > > O segredo de cliente dá acesso aos seus dados do ServiceTitan. Armazene-o com segurança e não o compartilhe. ## Configuração ### Conecte o Zapier Se ainda não fez isso, conecte o [Zapier](/docs/pt/reception-ai/integrations/zapier) no Reception.ai. ### Adicione as ações do ServiceTitan No seu servidor MCP do Zapier em [mcp.zapier.com](https://mcp.zapier.com), adicione as [ações abaixo](#actions) do app **ServiceTitan (3.0.X)**. Para conectar, informe o ID do seu tenant, o ID de cliente e o segredo de cliente, e escolha o ambiente de produção. Para cada campo, defina um valor fixo ou deixe a IA preenchê-lo, conforme indicado. ### Atribua as ferramentas No Reception.ai, abra a aba **Tools** da integração do Zapier, selecione **Refresh tools** e atribua cada ação ao **Client** (recepcionista). ### Teste [Teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) como alguém novo que precisa de um reparo. O agendamento aparecerá no ServiceTitan para sua equipe revisar. ## Ações ### Encontre quem está ligando | Campo | Valor | | ------------------------- | ----------------------------------------------- | | **Ação do Zapier** | **Search Customers** | | **Definir no Zapier** | Nada. | | **Deixar a IA preencher** | **Phone** (o número de quem ligou) ou **Name**. | | **Atribuir a** | **Client** | ### Envie um agendamento Um agendamento é a maneira mais segura de enviar novos trabalhos. Sua equipe de atendimento o revisa no ServiceTitan e o transforma em um trabalho, para que sua recepcionista nunca faça reservas diretamente no seu quadro de despacho. | Campo | Valor | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Ação do Zapier** | **Create Booking** | | **Definir no Zapier** | **Booking Provider**, **Source** (por exemplo, `Reception`) e, opcionalmente, **Business Unit**, **Job Type** e **Campaign**. | | **Deixar a IA preencher** | **Name**, **Summary** (o problema, o número de telefone de quem ligou e quando está disponível), **Is First Time Client**, o endereço do serviço, **Start** (o horário preferido de quem ligou) e **External Id**. | | **Atribuir a** | **Client** | **External Id** precisa ser exclusivo para cada agendamento. Adicione um [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures) instruindo sua recepcionista a usar o número de telefone de quem ligou seguido da data e hora atuais. ### Verifique os agendamentos de um cliente | Campo | Valor | | ------------------------- | ----------------------------------------- | | **Ação do Zapier** | **Search Appointments** | | **Definir no Zapier** | Nada. | | **Deixar a IA preencher** | **Customer Id**, de **Search Customers**. | | **Atribuir a** | **Client** | ## Limitações * O app do ServiceTitan no Zapier não pode verificar capacidade ou disponibilidade de técnicos, portanto o horário de um agendamento é a preferência de quem ligou, não um horário confirmado. * **Create Job** e **Create Appointment** exigem IDs para o local, a unidade de negócios, o tipo de trabalho e a campanha, além de agendar diretamente na sua agenda. Deixe isso para sua equipe de atendimento. * A integração está em beta aberto e o ServiceTitan não oferece suporte oficial a ela. * Cada ação executada pela sua recepcionista usa tarefas do seu plano do Zapier. Atualmente, o Zapier conta duas tarefas por chamada bem-sucedida; chamadas com falha não são contabilizadas. Quando o plano se esgota, as ações param até ele ser renovado. ## Solução de problemas | Problema | O que verificar | | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | Uma ação do ServiceTitan não aparece no Reception.ai | Selecione **Refresh tools** na integração do Zapier depois de adicionar ações no Zapier. | | Uma ação mostra **Changed** e não é usada | Você a editou no Zapier. Selecione **Update** na aba **Tools**. | | O Zapier não consegue se conectar ao ServiceTitan | Verifique se seu registro foi aprovado e se você usou um ID e segredo de cliente 3.0.X, não uma chave de API antiga. | | Erro `UniqueConstraint` em um agendamento | **External Id** repetiu um agendamento anterior. Verifique se inclui a data e a hora. | | Clientes conhecidos não são encontrados | Tente usar o nome de quem ligou, além do número de telefone. |