# Envie contatos para o Pipedrive com campos personalizados

> Use o bloco Requisição HTTP para criar pessoas no Pipedrive e preencher os campos personalizados com os dados de cada contato.

Fonte: https://gaio.social/ajuda/guias/enviar-contatos-pipedrive

Com o bloco **Requisição HTTP**, cada pessoa que fala com você no Instagram pode virar uma pessoa no seu Pipedrive, já com os campos personalizados preenchidos.

[Vídeo: Do token do Pipedrive ao teste do bloco Requisição HTTP na Gaio](https://media.gaio.social/help-center/02f248a9-f2ef-4dd4-bf55-3cac59bc0c5d.mp4)
## Pegue o token e as chaves no Pipedrive

Você vai precisar de duas informações do Pipedrive: o token de API e a chave de cada campo personalizado que quer preencher.

### Token de API

1. No Pipedrive, abra `Preferências pessoais` e selecione a aba `API`.
2. Clique em `Copiar` ao lado de **Seu token de API pessoal**.

   ![Botão Copiar do token de API no Pipedrive](https://media.gaio.social/help-center/15b820ee-8c2c-45fd-9b3e-ca3f35dfef20.webp)

O token dá acesso a todos os dados da sua conta no Pipedrive. Não compartilhe nem cole em mensagens.

### Chave do campo personalizado

1. Abra `Configurações` > `Campos de dados` e selecione a aba do tipo de registro, como `Pessoa`.
2. Na linha do campo, clique em `⋯` e escolha `Copiar chave de API`.

   ![Opção Copiar chave de API no menu do campo](https://media.gaio.social/help-center/71e9fc4a-e840-49cc-b99c-e01d3f50b743.webp)

A chave é um código de 40 caracteres, como `4814d2414eca556fe7b23ccc58c9c740f00f299b`. Cada campo tem a sua, e ela muda de uma conta do Pipedrive para outra.

## Crie a automação na Gaio

1. Selecione o botão abaixo. O Assistente abre numa nova aba com o pedido já enviado; se você não estiver logado, entre primeiro e ele continua de onde parou.

   [Pedir ao Assistente](https://app.gaio.social/assistant?prompt=UXVlcm8gdW1hIGF1dG9tYcOnw6NvIG5vIEluc3RhZ3JhbSBxdWUgY2FkYXN0cmUgbm8gbWV1IFBpcGVkcml2ZSBxdWVtIG1lIG1hbmRhciBETSwgcGVsbyBibG9jbyBkZSByZXF1aXNpw6fDo28gSFRUUC4gQ3JpZSBhIHBlc3NvYSBjb20gbyBub21lIGRvIGNvbnRhdG8gZSBvIEAgZG8gSW5zdGFncmFtIG5vIG1ldSBjYW1wbyBwZXJzb25hbGl6YWRvIEluc3RhZ3JhbS4gU2UgYSBjaGFtYWRhIGZhbGhhciwgYWRpY2lvbmUgYSB0YWcgZXJyby1waXBlZHJpdmUuIERlaXhlIG8gdG9rZW4gZG8gUGlwZWRyaXZlIGUgYSBjaGF2ZSBkbyBjYW1wbyBwYXJhIGV1IHByZWVuY2hlci4%3D)

   Se preferir, abra o `Assistente`, no menu lateral, e envie este pedido:

   > Quero uma automação no Instagram que cadastre no meu Pipedrive quem me mandar DM, pelo bloco de requisição HTTP. Crie a pessoa com o nome do contato e o @ do Instagram no meu campo personalizado Instagram. Se a chamada falhar, adicione a tag erro-pipedrive. Deixe o token do Pipedrive e a chave do campo para eu preencher.

   ![Pedido ao assistente](https://media.gaio.social/help-center/e9a8fa1b-1662-4dba-97b1-e1c07c71911a.webp)

2. O assistente cria a automação e lista em `Ações pendentes` o que falta preencher. Clique em `Editar` para abrir o bloco.

   ![Ações pendentes da automação](https://media.gaio.social/help-center/10e3a51c-40e4-4959-9870-e2d6ea573513.webp)

Prefere montar sozinho? Adicione um bloco **Requisição HTTP** com o método `POST` e siga os passos abaixo.

## Configure o bloco Requisição HTTP

### Endpoint

1. Em `Endpoint`, use só o começo do endereço da sua conta no Pipedrive, até `.pipedrive.com`, seguido de `/api/v2/persons`. Não cole o endereço inteiro do navegador:

   `https://suaempresa.pipedrive.com/api/v2/persons`

   ![Campo Endpoint](https://media.gaio.social/help-center/8f06a654-0b2c-4935-8f7c-7a47efcdea0f.webp)

Para criar um negócio em vez de uma pessoa, use `/api/v2/deals` e troque `name` por `title` nos dados da requisição.

### Token no cabeçalho

1. Em `Cabeçalhos`, adicione `x-api-token` e cole o token no valor.
2. Clique em `Guardar como segredo` no aviso que aparece. O valor vira `{secret.pipedrive_key}` e o token deixa de ficar visível para quem abre a automação.

   ![Aviso para guardar o token como segredo](https://media.gaio.social/help-center/1416812c-cf37-4904-b260-28e7b29cd450.webp)

Não coloque o token na URL (`?api_token=`). Ali ele fica exposto na automação e não pode ser guardado como segredo.

### Campos personalizados

1. Em `Dados da requisição`, use o modo `Visual`.
2. Crie a linha `name` com a variável do nome do contato, `{contact.name}`.
3. Crie a linha `custom_fields` e, dentro dela, uma linha para cada campo:
   - **Chave:** a chave de API do campo, copiada do Pipedrive.
   - **Valor:** uma variável da Gaio, preenchida com o dado de cada contato. No exemplo, `{contact.alias}` é o @ do Instagram.

   ![Campo personalizado no modo Visual](https://media.gaio.social/help-center/4c193b1d-5725-40a9-86df-321684f39463.webp)

O resultado em JSON fica assim:

```json
{
  "name": "{contact.name}",
  "custom_fields": {
    "4814d2414eca556fe7b23ccc58c9c740f00f299b": "{contact.alias}"
  }
}
```

Campos de **opção única** ou **múltipla escolha** recebem o número da opção, sem aspas, e não o texto dela. Por exemplo: `"fa11e00e6f51272df711ea63217b23f7ce500593": 39`. Com o texto ou com o número entre aspas, o Pipedrive recusa a requisição.

## Teste a requisição

1. Abra a aba `Mapeamento` e clique em `Enviar teste`.
2. Se a resposta trouxer `"success": true`, a pessoa foi criada no Pipedrive com os campos preenchidos.

   ![Resposta do teste](https://media.gaio.social/help-center/2eccef22-38f9-45e1-a409-990cc76dc20f.webp)

Para usar a pessoa criada nos próximos blocos, mapeie `$.data.id` para uma variável. Ligue a saída de falha do bloco a uma etiqueta, como `erro-pipedrive`, para encontrar os contatos que não foram enviados.

## Perguntas frequentes

### Onde encontro o endereço da minha conta no Pipedrive?

É o começo do endereço que aparece no navegador quando você abre o Pipedrive, como `suaempresa.pipedrive.com`.

### Como descubro o número de uma opção de campo?

Abra `https://suaempresa.pipedrive.com/api/v2/personFields` no navegador, com o Pipedrive aberto na mesma sessão, e procure o campo pela chave. Cada opção aparece com `id` e `label`. Para negócios, use `dealFields`.

### Posso preencher vários campos personalizados na mesma requisição?

Sim. Adicione uma linha dentro de `custom_fields` para cada campo, cada uma com a chave do campo e a variável do valor.

### A requisição deu erro. O que confiro primeiro?

O endereço da conta no endpoint, o cabeçalho `x-api-token`, as chaves dos campos e, nos campos de opção, se o valor é o número da opção sem aspas.

### O teste devolveu uma página HTML. O que está errado?

O `Endpoint` aponta para uma página do Pipedrive, não para a API. Use só o começo do endereço, até `.pipedrive.com`, seguido de `/api/v2/persons`. Um token errado devolve um erro em JSON (401), não HTML.