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

# Pipedrive

Com as [ferramentas de webhook](/docs/pt/reception-ai/integrations/webhooks) abaixo, sua recepcionista pode reconhecer pessoas que ligam e já estão no Pipedrive, abrir um negócio para uma nova oportunidade e agendar uma ligação de acompanhamento para sua equipe.

## Antes de começar

No Pipedrive, abra **Preferências pessoais** → **API** e copie seu token de API. Todas as ferramentas abaixo o enviam no cabeçalho de solicitação `x-api-token`. As ferramentas agem como você, então use o token de um usuário que possa ver o funil correto.

## Crie as ferramentas

Para cada ferramenta, acesse **Integrações**, selecione **Adicionar integração**, escolha **Ferramenta de webhook** e defina **Atribuir aos agentes** como **Recepcionista**.

### Encontrar uma pessoa que ligou

| Campo                         | Valor                                                                                                                                                     |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                      | `find_pipedrive_person`                                                                                                                                   |
| **Descrição**                 | "Encontre a pessoa que ligou no nosso CRM pelo número de telefone ou nome. Use no início de uma ligação sobre uma venda, orçamento ou negócio existente." |
| **Método**                    | GET                                                                                                                                                       |
| **URL**                       | `https://api.pipedrive.com/api/v2/persons/search`                                                                                                         |
| **Cabeçalhos da solicitação** | `x-api-token`: seu token de API                                                                                                                           |
| **Parâmetros de consulta**    | `term` (string, obrigatório): "O número de telefone ou nome completo da pessoa que ligou, com pelo menos 2 caracteres."                                   |

### Abrir um negócio

| Campo                         | Valor                                                                                                                                                                                                                                                            |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                      | `create_pipedrive_deal`                                                                                                                                                                                                                                          |
| **Descrição**                 | "Abra um negócio quando uma pessoa que ligou quiser um orçamento ou comprar. Inclua o nome dela no título."                                                                                                                                                      |
| **Método**                    | POST                                                                                                                                                                                                                                                             |
| **URL**                       | `https://api.pipedrive.com/api/v2/deals`                                                                                                                                                                                                                         |
| **Cabeçalhos da solicitação** | `x-api-token`: seu token de API                                                                                                                                                                                                                                  |
| **Parâmetros do corpo**       | `title` (string, obrigatório): "Título curto com o nome da pessoa que ligou e o que ela quer."  `person_id` (number): "O id de `find_pipedrive_person`. Omita se a pessoa não foi encontrada."  `value` (number): "O valor do negócio, se a pessoa informou um." |

### Agendar um acompanhamento

| Campo                         | Valor                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                      | `create_pipedrive_followup`                                                                                                                                                                                                                                                                                                                                                                                               |
| **Descrição**                 | "Agende uma ligação de retorno da equipe sempre que prometer um acompanhamento à pessoa que ligou."                                                                                                                                                                                                                                                                                                                       |
| **Método**                    | POST                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **URL**                       | `https://api.pipedrive.com/api/v2/activities`                                                                                                                                                                                                                                                                                                                                                                             |
| **Cabeçalhos da solicitação** | `x-api-token`: seu token de API                                                                                                                                                                                                                                                                                                                                                                                           |
| **Parâmetros do corpo**       | `subject` (string, obrigatório): "Por exemplo: Retornar a ligação de Jane Doe sobre um orçamento de cozinha."  `type` (string, obrigatório): "Sempre o valor exato `call`."  `due_date` (string, obrigatório): "A data de acompanhamento no formato AAAA-MM-DD."  `note` (string, obrigatório): "O nome, número de telefone e necessidade da pessoa que ligou."  `deal_id` (number): "O id do negócio, se você abriu um." |

Selecione **Ativar** em cada ferramenta e [teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) com uma ligação pedindo um orçamento.

## Limitações

As ferramentas de webhook enviam valores simples, e o Pipedrive armazena os números de telefone de uma pessoa como uma lista aninhada. Por isso, essas ferramentas não conseguem criar um novo contato com um número de telefone. A nota do acompanhamento mantém o número da pessoa que ligou. Para criar contatos, use a ação **Create Person** do Pipedrive pelo [Zapier](/docs/pt/reception-ai/integrations/zapier).

## Solução de problemas

| Problema                               | O que verificar                                                                                                                             |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| 401 do Pipedrive                       | O cabeçalho deve se chamar `x-api-token` e conter um token atual.                                                                           |
| Pessoas conhecidas não são encontradas | O Pipedrive corresponde aos números de telefone conforme armazenados. Armazene os números em um único formato ou pesquise também pelo nome. |
| O acompanhamento não tem tipo          | `call` deve ser um tipo de atividade na sua conta do Pipedrive. Verifique **Configurações da empresa** → **Atividades**.                    |