Envie contatos para o Pipedrive com campos personalizados

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.

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.

   

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.

   

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

   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.

   

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

   

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

   

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.

   

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.

   

O resultado em JSON fica assim:

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

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.

   

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.