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

# Capsule CRM

Sua recepcionista pode reconhecer pessoas que ligam e já estão no Capsule, adicionar novas pessoas como contatos, registrar o que cada pessoa queria e criar uma tarefa de acompanhamento para sua equipe. A busca por quem liga usa uma [ferramenta de webhook](/docs/pt/reception-ai/integrations/webhooks). A adição de contatos, notas e tarefas é feita pelo [Zapier](/docs/pt/reception-ai/integrations/zapier), pois a API do Capsule exige corpos de solicitação aninhados para essas ações, que as ferramentas de webhook não conseguem enviar.

## Buscar quem liga

### Criar um token de API

No Capsule, abra **My Preferences** → **API Authentication Tokens** e gere um novo token. Dê a ele um nome, por exemplo, `Reception.ai`. O token age como você, então pode ver e alterar tudo o que você pode.

> **Warning**
>
> Qualquer pessoa com o token pode ler e alterar seus dados do Capsule. Não o inclua em documentos compartilhados e
> exclua-o no Capsule se ele vazar.

### Criar a ferramenta de webhook

Vá para **Integrations**, selecione **Add integration** e escolha **Webhook Tool**.

| Campo                         | Valor                                                                                                                                                       |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                      | `find_capsule_contact`                                                                                                                                      |
| **Descrição**                 | "Encontre quem está ligando em nosso CRM pelo número de telefone, nome ou e-mail. Use esta ferramenta no início da chamada para verificar se já é cliente." |
| **Método**                    | GET                                                                                                                                                         |
| **URL**                       | `https://api.capsulecrm.com/api/v2/parties/search`                                                                                                          |
| **Cabeçalhos da solicitação** | `Authorization`: `Bearer ` seguido do seu token                                                                                                             |
| **Parâmetros de consulta**    | `q` (string, obrigatório): "O número de telefone, nome completo ou endereço de e-mail de quem está ligando."                                                |
| **Atribuir a agentes**        | **Receptionist**                                                                                                                                            |

Selecione **Enable**. A busca retorna os mesmos resultados da própria barra de pesquisa do Capsule.

## Adicionar contatos, notas e tarefas

### Conectar o Zapier

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

### Adicionar as ações do Capsule

No seu servidor MCP do Zapier em [mcp.zapier.com](https://mcp.zapier.com), conecte sua conta do Capsule CRM e adicione as [ações abaixo](#actions). Para cada campo, defina um valor fixo ou deixe a IA preenchê-lo, conforme indicado.

### Atribuir as ferramentas

No Reception.ai, abra a aba **Tools** da integração do Zapier, selecione **Refresh tools** e atribua cada ação conforme indicado.

### Testar

[Teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) com uma chamada de um número salvo em um contato do Capsule e, depois, como uma nova pessoa que liga e pede um retorno. O novo contato, uma nota e uma tarefa aparecerão no Capsule.

## Ações

### Adicionar quem liga

| Campo                     | Valor                                                     |
| ------------------------- | --------------------------------------------------------- |
| **Ação do Zapier**        | **Create Contact**                                        |
| **Definir no Zapier**     | O tipo (Person), o responsável e quaisquer tags.          |
| **Deixar a IA preencher** | Nome, sobrenome, número de telefone e endereço de e-mail. |
| **Atribuir a**            | **Client**                                                |

### Registrar uma nota

| Campo                     | Valor                                                                       |
| ------------------------- | --------------------------------------------------------------------------- |
| **Ação do Zapier**        | **Add Note to Entity**                                                      |
| **Definir no Zapier**     | O tipo de registro ao qual adicionar a nota: um contato.                    |
| **Deixar a IA preencher** | O ID do contato (de `find_capsule_contact` ou **Create Contact**) e a nota. |
| **Atribuir a**            | **Client**                                                                  |

### Criar uma tarefa de acompanhamento

| Campo                     | Valor                                                                     |
| ------------------------- | ------------------------------------------------------------------------- |
| **Ação do Zapier**        | **Create Task**                                                           |
| **Definir no Zapier**     | O membro da equipe que atende retornos de chamada.                        |
| **Deixar a IA preencher** | A descrição, a data de vencimento e o contato ao qual a tarefa se refere. |
| **Atribuir a**            | **Client**                                                                |

> **Tip**
>
> Adicione um [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures) para que sua recepcionista
> primeiro procure quem está ligando e só crie um contato quando não encontrar nenhuma correspondência.

## Limitações

* O app Capsule do Zapier não consegue verificar a disponibilidade de ninguém, então sua recepcionista não pode agendar reuniões no Capsule. Em vez disso, use a tarefa de acompanhamento ou o agendamento próprio do Reception com o [Google Calendar](/docs/pt/reception-ai/integrations/google-calendar).
* Cada ação do Zapier executada pela sua recepcionista consome tarefas do seu plano do Zapier. Atualmente, o Zapier contabiliza duas tarefas por chamada bem-sucedida; chamadas com falha não são contabilizadas. Quando o plano acaba, as ações param até que ele seja renovado.

## Solução de problemas

| Problema                                         | O que verificar                                                                                                                        |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| 401 do Capsule                                   | Comece o valor do cabeçalho com `Bearer ` e um espaço e verifique se o token não foi excluído.                                         |
| Pessoas conhecidas que ligam não são encontradas | O Capsule corresponde aos números de telefone conforme armazenados. Salve os números em um único formato ou busque por nome ou e-mail. |
| A recepcionista cria contatos duplicados         | Informe na descrição da ferramenta de busca que ela deve adicionar um contato somente quando não encontrar quem está ligando.          |
| Uma ação do Capsule 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**.                                                                        |