# Crie negócios no Pipedrive ligados à pessoa

> Cadastre a pessoa, faça as perguntas do fluxo e crie um negócio ligado a ela, com as respostas nos campos personalizados do negócio.

Fonte: https://gaio.social/ajuda/guias/criar-negocios-pipedrive

Este guia mostra uma automação de qualificação que termina num negócio no Pipedrive: a pessoa é cadastrada assim que manda DM, responde a faixa de investimento e o WhatsApp, e um negócio é criado ligado a ela, com as duas respostas nos campos do negócio.

[Vídeo: Do campo de negócio no Pipedrive ao negócio criado pela Gaio, ligado à pessoa](https://media.gaio.social/help-center/7a8ee686-0475-4c3b-8c72-0cc3d18549df.mp4)
O fluxo fica assim:

1. **Requisição HTTP** cria a pessoa e guarda o id dela.
2. **Botões** perguntam a faixa de investimento.
3. Em cada botão, um bloco **Campo personalizado** guarda o número da opção da faixa no Pipedrive.
4. **Pergunta** pede o WhatsApp.
5. Uma única **Requisição HTTP** cria o negócio, ligado à pessoa.
6. A saída `Falha` de cada requisição adiciona a etiqueta `erro-pipedrive` e segue o fluxo.

Antes de começar, siga [Envie contatos para o Pipedrive](https://gaio.social/ajuda/guias/enviar-contatos-pipedrive) para pegar o token e montar o bloco que cria a pessoa.

## Pegue as chaves e as opções no Pipedrive

### Chaves dos campos do negócio

1. No Pipedrive, abra `Configurações` > `Campos de dados` e selecione a aba `Lead/negócio`.
2. Na linha de cada campo que vai preencher, clique em `⋯` e escolha `Copiar chave de API`.

   ![Opção Copiar chave de API no campo Faixa de investimento](https://media.gaio.social/help-center/90051677-5bd1-4136-b115-b5916274d4bd.webp)

Os campos do negócio têm chaves diferentes dos campos da pessoa, mesmo quando o nome é igual.

### Números das opções

Um campo de **opção única**, como a faixa de investimento, recebe o número da opção, não o texto.

1. Com o Pipedrive aberto, abra numa nova aba o endereço do campo: `https://suaempresa.pipedrive.com/api/v2/dealFields/CHAVE_DO_CAMPO`, trocando `CHAVE_DO_CAMPO` pela chave.
2. Em `options`, cada opção aparece com `id` e `label`, como `"id": 41, "label": "Até R$1.000"`.

   ![Opções do campo com id e label](https://media.gaio.social/help-center/fbf6133d-673e-4f0b-b991-ed342bfe782f.webp)
3. Anote o `id` de cada opção.

## Crie os campos na Gaio

As respostas do contato ficam em campos personalizados da Gaio, que o bloco do negócio lê como variáveis. Em `Configurações` › `Campos Personalizados`, crie:

- **Faixa Pipedrive**, do tipo `Número (valor)`: guarda o número da opção. Ele vira a variável `{faixa-pipedrive}`.
- **WhatsApp**, do tipo `Telefone`: guarda a resposta da pergunta. Ele vira a variável `{whatsapp}`.

Veja [Campos personalizados](https://gaio.social/ajuda/campos-personalizados) para criar um campo.

## Crie a automação na Gaio

1. Selecione o botão abaixo. O Assistente abre numa nova aba com o pedido já enviado.

   [Pedir ao Assistente](https://app.gaio.social/assistant?prompt=UXVlcm8gdW1hIGF1dG9tYcOnw6NvIG5vIEluc3RhZ3JhbSBxdWUgY2FkYXN0cmUgbm8gbWV1IFBpcGVkcml2ZSBxdWVtIG1lIG1hbmRhciBETSwgcGVyZ3VudGUgYSBmYWl4YSBkZSBpbnZlc3RpbWVudG8gbWVuc2FsIChhdMOpIFIkMS4wMDAsIGRlIFIkMS4wMDAgYSBSJDMuMDAwIGUgYWNpbWEgZGUgUiQzLjAwMCkgZSBvIFdoYXRzQXBwLCBlIGNyaWUgdW0gbmVnw7NjaW8gbGlnYWRvIMOgIHBlc3NvYSwgY29tIGEgZmFpeGEgZSBvIFdoYXRzQXBwIG5vcyBjYW1wb3MgcGVyc29uYWxpemFkb3MgZG8gbmVnw7NjaW8uIFNlIHVtYSBjaGFtYWRhIGZhbGhhciwgYWRpY2lvbmUgYSB0YWcgZXJyby1waXBlZHJpdmUgZSBzaWdhIG8gZmx1eG8uIERlaXhlIG8gdG9rZW4sIGFzIGNoYXZlcyBkb3MgY2FtcG9zIGUgb3MgbsO6bWVyb3MgZGFzIG9ww6fDtWVzIHBhcmEgZXUgcHJlZW5jaGVyLg%3D%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, pergunte a faixa de investimento mensal (até R$1.000, de R$1.000 a R$3.000 e acima de R$3.000) e o WhatsApp, e crie um negócio ligado à pessoa, com a faixa e o WhatsApp nos campos personalizados do negócio. Se uma chamada falhar, adicione a tag erro-pipedrive e siga o fluxo. Deixe o token, as chaves dos campos e os números das opções para eu preencher.

   ![Pedido ao assistente](https://media.gaio.social/help-center/1c0de781-b6a2-4521-8c2e-a20c90a142a7.webp)

2. Em `Ações pendentes`, preencha o endereço da sua conta, o token, as chaves dos campos e o número de cada opção. Clique em `Editar` para abrir cada bloco. No bloco, cada item que falta aparece como uma etiqueta amarela com o nome dele, como `SEU_DOMINIO`: clique nela, digite o valor e aperte `Enter`.

   ![Ações pendentes da automação](https://media.gaio.social/help-center/bfac4e2a-d24c-4f09-a9e3-e8f5f145b55e.webp)

Prefere montar sozinho? Siga os passos abaixo.

## Monte o fluxo

### 1. Cadastre a pessoa

Monte o bloco **Requisição HTTP** da pessoa como em [Envie contatos para o Pipedrive](https://gaio.social/ajuda/guias/enviar-contatos-pipedrive). Na aba `Mapeamento`, guarde `$.data.id` com `Guardar só nesta execução`, em `Nome da variável` `pipedrive_id`. O negócio usa esse id para se ligar à pessoa.

### 2. Pergunte a faixa e guarde o número da opção

1. Depois da pessoa, adicione um bloco **Botões** com uma opção por faixa, como `Até R$1.000`, `R$1.000 a R$3.000` e `Acima de R$3.000`.
2. Ligue cada botão a um bloco **Campo personalizado**. Em `Campo`, escolha **Faixa Pipedrive**; em `Valor do campo`, escreva o `id` da opção no Pipedrive, como `41`.

   ![Bloco Campo personalizado com o id da opção](https://media.gaio.social/help-center/cf85d618-5cb2-4819-868c-9bbfca5627b1.webp)
3. Ligue os três blocos **Campo personalizado** ao mesmo próximo passo: a pergunta do WhatsApp.

### 3. Pergunte o WhatsApp

Adicione um bloco **Pergunta** que pede o WhatsApp e salva a resposta no campo **WhatsApp**.

### 4. Crie o negócio

Depois da pergunta, adicione **um** bloco **Requisição HTTP**:

1. Em `Método`, escolha `POST`.
2. Em `Endpoint`, use `https://suaempresa.pipedrive.com/api/v2/deals`.

   ![Campo Endpoint com o endereço de negócios](https://media.gaio.social/help-center/ccdb4a51-15ca-4c87-b870-4fc843e724b6.webp)
3. Em `Cabeçalhos`, adicione o mesmo `x-api-token` do bloco da pessoa, com o segredo `{secret.pipedrive_key}` no valor.
4. Em `Dados da requisição`, no modo `Visual`, adicione:
   - `title`, do tipo `Texto`: o título do negócio, como `Lead {contact.name}`.
   - `person_id`, do tipo `Número`: a variável `{pipedrive_id}`.
   - `custom_fields`, do tipo `Objeto`, com um campo para cada campo do negócio. Na chave, a chave do campo; no valor, digite `{` e escolha a variável.

Quando o valor é um campo personalizado da Gaio, o tipo segue o campo: `{faixa-pipedrive}` vai como `Número`, e `{whatsapp}`, como `Texto`.

![Dados da requisição no modo Visual, com o tipo de cada linha](https://media.gaio.social/help-center/14d4029f-a743-473f-b6fe-28416195705c.webp)

O resultado em JSON fica assim:

```json
{
  "title": "Lead {contact.name}",
  "person_id": {pipedrive_id},
  "custom_fields": {
    "e4ddde67785c1e7321d77281bdb3285ad9ff8491": {faixa-pipedrive},
    "1524f889c366e01cb549b270c0f67a07700a3311": "{whatsapp}"
  }
}
```

`person_id` e a faixa vão sem aspas, porque são números. O WhatsApp vai entre aspas, porque é texto.

Não coloque um bloco de negócio em cada botão. Cada um cria o seu negócio, e o contato que volta ao fluxo fica com negócios repetidos. Guarde a escolha num campo, como no passo 2, e crie o negócio uma vez só, depois das perguntas.

### 5. Ligue as saídas de falha

Nas duas requisições, ligue a saída `Falha` a um bloco **Etiquetas** que adiciona `erro-pipedrive`, e ligue esse bloco ao próximo passo do fluxo:

- na pessoa, à pergunta da faixa;
- no negócio, à mensagem seguinte, como o link de agendamento.

Assim nenhum contato fica sem resposta quando o Pipedrive recusa uma requisição.

## Teste o negócio

1. Abra o bloco do negócio, na aba `Mapeamento`, e vá até `Testar a requisição`.
2. Em `Contato do teste`, escolha um contato que já respondeu as perguntas. As `Variáveis da requisição` são preenchidas com os dados dele.
3. `{pipedrive_id}` só existe durante a execução: ao lado dele, digite o id de uma pessoa que já está no Pipedrive.

   ![Variáveis da requisição preenchidas com o contato do teste](https://media.gaio.social/help-center/709cef7f-80e5-45d5-b817-5fa8bf6c0721.webp)
4. Clique em `Enviar teste`. Com `"success": true`, o negócio foi criado; confira no Pipedrive se ele está na pessoa certa e com os campos preenchidos.

   ![Resposta do teste com o negócio criado](https://media.gaio.social/help-center/30a92039-46cc-427d-9d52-c54fa0bd2800.webp)

   ![Negócio no Pipedrive com a faixa e o WhatsApp preenchidos](https://media.gaio.social/help-center/082ff1ab-2d5f-48da-8a40-c874008b4fe7.webp)

## Se der erro

| O que aconteceu | O que conferir |
|---|---|
| Erro 401 | O cabeçalho se chama `x-api-token`, com o token da conta certa. |
| Erro 400 "Deal title must be given" | O bloco tem `Dados da requisição` com o campo `title`. |
| Negócio criado sem a pessoa | A pessoa guarda `$.data.id` em `pipedrive_id`, e o negócio manda `{pipedrive_id}` como `Número`. |
| Faixa vazia ou recusada | O campo guarda o `id` da opção, e a linha vai como `Número`, sem aspas. |
| Negócios repetidos ou sem título | Há um bloco de negócio em cada botão. Deixe um só, depois das perguntas. |
| A conversa parou no bloco | A saída `Falha` não está ligada. |

## Perguntas frequentes

### Por que o negócio precisa do `person_id`?

É o que liga o negócio à pessoa no Pipedrive. Sem ele, o negócio fica solto, sem contato.

### Posso pôr o número da opção direto no botão?

O botão só leva ao próximo bloco, não guarda valor. Por isso cada botão passa por um bloco **Campo personalizado** que guarda o número da opção.

### O tipo da linha está travado em `Texto`. Por quê?

O valor é um campo personalizado que não é numérico, como Telefone ou Texto. Para mandar um número, use um campo do tipo `Número (valor)`.

### Quero mandar um número como texto.

Num campo `Número (valor)`, troque o tipo da linha para `Texto`: o valor vai entre aspas.

### Como encontro quem não chegou ao Pipedrive?

Filtre os contatos pela etiqueta `erro-pipedrive`. A aba `Histórico` do bloco mostra a resposta do Pipedrive em cada falha.
