> 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.

# Workiz

Sua recepcionista pode adicionar quem liga ao Workiz como um novo lead, com os dados de contato, endereço do serviço e o que precisa, para que sua equipe possa fazer o acompanhamento e agendar o trabalho. A API do Workiz espera que o segredo esteja no corpo da solicitação, onde as ferramentas de webhook o exporiam à IA, por isso o Reception se conecta pelo [Zapier](/docs/pt/reception-ai/integrations/zapier).

O app do Workiz no Zapier pode criar leads e trabalhos, mas não consegue pesquisar clientes nem verificar sua agenda.

## Antes de começar

O Zapier se conecta ao Workiz usando seu token e segredo de API, que exigem o complemento Developer API:

1. No Workiz, selecione **Feature Center** na barra de navegação.
2. Em **Add-ons**, selecione **Developer API** e ative a opção.
3. Abra a página **Developer** e copie seu token e segredo de API. O Zapier solicita ambos quando você conecta o Workiz.

Se você não conseguir ver o **Feature Center** ou a página **Developer**, peça ao administrador da sua conta para ativar a permissão **Account Settings** para seu tipo de usuário em **Roles & Permissions**.

> **Warning**
>
> O token e o segredo de API dão acesso à sua conta do Workiz. Guarde-os em segurança e não os compartilhe.

## Configurar

### Conectar o Zapier

Se ainda não tiver feito isso, conecte o [Zapier](/docs/pt/reception-ai/integrations/zapier) no Reception.ai.

### Adicionar a ação do Workiz

No seu servidor MCP do Zapier em [mcp.zapier.com](https://mcp.zapier.com), adicione a ação **Create Lead** do Workiz e conecte sua conta. Os campos do Zapier não estão na mesma ordem que na página **Developer** do Workiz, então cole o token e o segredo nos campos correspondentes.

| Campo                     | Valor                                                                                                                                                                            |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ação do Zapier**        | **Create Lead**                                                                                                                                                                  |
| **Definir no Zapier**     | A origem do trabalho, por exemplo, `Reception`. Ela já deve existir como uma origem de anúncio no Workiz.                                                                        |
| **Deixar a IA preencher** | Nome e sobrenome, telefone, e-mail, endereço do serviço e as observações do lead: o que a pessoa precisa, quando está disponível e qualquer outra informação que ela tenha dado. |
| **Atribuir a**            | **Client**                                                                                                                                                                       |

### Atribuir a ferramenta

No Reception.ai, abra a guia **Tools** da integração do Zapier, selecione **Refresh tools** e atribua **Create Lead** ao **Client** (recepcionista).

### Testar

[Teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) como uma nova pessoa que liga precisando de um reparo. O lead aparecerá no Workiz com a origem do seu trabalho.

> **Tip**
>
> Adicione um [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures) instruindo sua recepcionista
> a pedir o endereço completo com o CEP e um número de telefone de 10 dígitos antes de criar o
> lead.

## Limitações

* Sua recepcionista não consegue encontrar clientes existentes, então quem já ligou pode ser adicionado como um novo lead. Filtre pela origem do trabalho no Workiz para revisar novos leads.
* O app do Workiz no Zapier não consegue verificar sua agenda. **Create Job** agenda um trabalho em um horário definido e exige um tipo de trabalho, então deixe isso para sua equipe, a menos que você queira que os horários preferidos pelas pessoas sejam incluídos diretamente no calendário.
* 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, a ação para até ser renovado.

## Solução de problemas

| Problema                                    | O que verificar                                                                                                                                   |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Create Lead** não aparece no Reception.ai | Selecione **Refresh tools** na integração do Zapier após adicionar a ação no Zapier.                                                              |
| A ação mostra **Changed** e não é usada     | Você a editou no Zapier. Selecione **Update** na guia **Tools**.                                                                                  |
| O Zapier informa falha na autenticação      | O token e o segredo podem estar nos campos errados ou não serem mais válidos. Copie-os novamente da página **Developer**.                         |
| Erro de validação de campo do Workiz        | A origem do trabalho deve corresponder exatamente a uma origem de anúncio no Workiz. Os números de telefone precisam ter 10 dígitos e os CEPs, 5. |