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

# Nutshell

Sua recepcionista pode reconhecer interlocutores que já estão no Nutshell e adicionar novos interlocutores como pessoas com um lead para sua equipe acompanhar. A busca de interlocutores usa uma [ferramenta de webhook](/docs/pt/reception-ai/integrations/webhooks). A adição de pessoas e leads é feita pelo [Zapier](/docs/pt/reception-ai/integrations/zapier), porque a API do Nutshell exige listas e valores aninhados para criar registros, que as ferramentas de webhook não conseguem enviar.

## Procurar interlocutores

### Criar uma chave de API

No Nutshell, selecione **Settings** no canto inferior esquerdo e depois **API keys** em **Connections**. Selecione **Add API key** e escolha **API + user impersonation**, que o Zapier também exige. Copie a chave.

### Criar o cabeçalho de autorização

A API do Nutshell usa seu endereço de e-mail do Nutshell como nome de usuário e a chave de API como senha. Codifique-os em um terminal, substituindo os dois valores e mantendo os dois-pontos entre eles:

```bash
printf 'YOUR_EMAIL:YOUR_API_KEY' | base64
```

O valor do cabeçalho é `Basic ` seguido da saída.

> **Warning**
>
> Não cole sua chave de API em um codificador on-line. Qualquer pessoa com a chave ou o cabeçalho codificado pode
> ler e alterar seus dados do Nutshell.

### Criar a ferramenta de webhook

Acesse **Integrations**, selecione **Add integration** e escolha **Webhook Tool**.

| Campo                         | Valor                                                                                                                                                  |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Nome**                      | `find_nutshell_person`                                                                                                                                 |
| **Descrição**                 | "Encontre o interlocutor em nosso CRM pelo telefone, nome ou e-mail. Use esta ferramenta no início de uma chamada para verificar se ele já é cliente." |
| **Método**                    | GET                                                                                                                                                    |
| **URL**                       | `https://app.nutshell.com/rest/contacts`                                                                                                               |
| **Cabeçalhos da solicitação** | `Authorization`: `Basic ` seguido do valor codificado                                                                                                  |
| **Parâmetros de consulta**    | `q` (string, obrigatório): "O telefone, nome completo ou endereço de e-mail do interlocutor."                                                          |
| **Atribuir a agentes**        | **Receptionist**                                                                                                                                       |

Selecione **Enable**.

## Adicionar pessoas e leads

### 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 Nutshell

No seu servidor MCP do Zapier em [mcp.zapier.com](https://mcp.zapier.com), conecte sua conta do Nutshell com a chave de API e adicione estas ações:

* **Create Person**: deixe a IA preencher o nome, telefone e endereço de e-mail do interlocutor.
* **Create Lead**: defina a origem, o pipeline e o responsável como valores fixos e deixe a IA preencher uma descrição do que o interlocutor deseja e da pessoa a que se refere.

> **Tip**
>
> Para registrar a chamada na linha do tempo da pessoa, adicione também **Log Activity** e deixe a IA preencher
> um breve resumo.

### Atribuir as ferramentas

No Reception.ai, abra a aba **Tools** da integração do Zapier, selecione **Refresh tools** e atribua as ações do Nutshell ao **Client** (recepcionista).

### Testar

[Teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) com uma chamada de um número salvo em uma pessoa do Nutshell e depois como um novo interlocutor que quer um orçamento. A nova pessoa e o lead dela aparecerão no Nutshell.

## Limitações

* O app do Nutshell no Zapier não tem uma ação para criar uma tarefa de acompanhamento. Em vez disso, o responsável pelo lead vê os novos leads no Nutshell.
* O app do Nutshell no Zapier não consegue verificar a disponibilidade de ninguém, portanto, sua recepcionista não pode agendar reuniões no Nutshell. Use o próprio agendamento do Reception com o [Google Calendar](/docs/pt/reception-ai/integrations/google-calendar).
* Cada ação do Zapier executada pela sua recepcionista usa tarefas do seu plano Zapier. Atualmente, o Zapier contabiliza 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                                                                                                                |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| 401 do Nutshell                                  | Codifique seu endereço de e-mail do Nutshell, dois-pontos e a chave, e inicie o valor do cabeçalho com `Basic `.               |
| Interlocutores conhecidos não são encontrados    | Tente uma chamada de teste de um número salvo em uma pessoa do Nutshell ou peça o nome ao interlocutor.                        |
| A recepcionista cria pessoas duplicadas          | Informe na descrição da ferramenta de busca que ela deve adicionar uma pessoa apenas quando o interlocutor não for encontrado. |
| Uma ação do Nutshell não aparece no Reception.ai | Selecione **Refresh tools** na integração do Zapier após adicionar ações no Zapier.                                            |
| O Zapier não consegue se conectar ao Nutshell    | Use uma chave de API com **API + user impersonation**.                                                                         |