Ir para a navegação

Keap

Encontre e adicione contatos do Keap e registre observações e tarefas de acompanhamento durante as chamadas.

Sua recepcionista pode reconhecer pessoas que ligam e já estão no Keap, adicionar novas pessoas como contatos, registrar o que cada pessoa queria e criar uma tarefa de acompanhamento para sua equipe. Há duas formas de conectar:

  • As ferramentas de webhook chamam a API do Keap diretamente com um Token de Acesso Pessoal, sem conta do Zapier e sem uso de tarefas do Zapier.
  • As ações do Zapier fazem login no Keap para você, mas cada ação usa tarefas do seu plano do Zapier.

Use as ferramentas de webhook, a menos que prefira não criar um token de acesso do Keap.

Opção 1: Ferramentas de webhook (recomendado)

1

Crie um Token de Acesso Pessoal

No Keap, abra o menu Settings e selecione API Settings. No Keap Classic, essa opção fica no menu Profile. Adicione uma nova chave, dê um nome a ela, por exemplo Reception.ai, e copie-a imediatamente: o Keap mostra a chave completa apenas uma vez.

Crie um Token de Acesso Pessoal, não uma Chave de Conta de Serviço. Um Token de Acesso Pessoal atua como você e pode ver o que você vê, enquanto uma Chave de Conta de Serviço tem acesso de administrador a todos os seus dados do Keap. Exclua a chave em API Settings caso ela vaze.

2

Encontre os IDs que serão definidos

Novos contatos, notas e tarefas precisam do ID do usuário ao qual pertencem, e você também pode definir a origem do lead dos novos contatos. Execute estes comandos em um terminal, substituindo YOUR_TOKEN, e anote o id de cada valor que quiser:

curl -H "Authorization: Bearer YOUR_TOKEN" https://api.infusionsoft.com/crm/rest/v2/users
curl -H "Authorization: Bearer YOUR_TOKEN" https://api.infusionsoft.com/crm/rest/v2/leadSources
3

Crie as ferramentas de webhook

Para cada ferramenta abaixo, acesse Integrations, selecione Add integration e escolha Webhook Tool. Todas as ferramentas enviam o mesmo cabeçalho: Authorization (Secret), definido como Bearer seguido do seu token.

Encontre quem está ligando

CampoValor
Nomefind_keap_contact
Descrição”Encontre quem está ligando em nosso CRM pelo endereço de e-mail ou número de telefone. Use esta ferramenta no início de uma chamada para verificar se a pessoa já é cliente. Passe o id do contato para as ferramentas de nota e tarefa.”
MétodoGET
URLhttps://api.infusionsoft.com/crm/rest/v2/contacts
Cabeçalhos da solicitaçãoAuthorization (Secret): Bearer seguido do seu token
Parâmetros de consultafilter (string, obrigatório, da conversa): “Para pesquisar por e-mail, escreva email== e o endereço de e-mail de quem está ligando, por exemplo email==jane@example.com. Para pesquisar por telefone, escreva phone_number== e os dígitos do número, depois ;phone_fields==PHONE1, por exemplo phone_number==5551234567;phone_fields==PHONE1.”
fields (string, valor fixo): id,given_name,family_name
page_size (integer, valor fixo): 5
Atribuir a agentesRecepcionista

fields limita a resposta ao ID e nome de cada correspondência, para que a ferramenta nunca retorne outros detalhes salvos no contato.

A IA escreve todo o filter, e o filtro do Keap também pode encontrar correspondências por nome, cidade ou um prefixo de nome, como given_name==J*. Quem está ligando poderia convencer sua recepcionista a listar os nomes e IDs de até cinco outros contatos e, em seguida, adicionar notas ou tarefas a eles. Adicione uma regra instruindo sua recepcionista a pesquisar apenas pelo próprio número de telefone ou endereço de e-mail de quem está ligando e nunca dizer o nome de outro contato.

Adicione quem está ligando

CampoValor
Nomecreate_keap_contact
Descrição”Adicione quem está ligando como contato apenas quando find_keap_contact não encontrar essa pessoa. Passe o id do novo contato para as ferramentas de nota e tarefa.”
MétodoPOST
URLhttps://api.infusionsoft.com/crm/rest/v2/contacts
Cabeçalhos da solicitaçãoAuthorization (Secret): Bearer seguido do seu token
Parâmetros do corpoVeja abaixo
Atribuir a agentesRecepcionista
  • given_name (string, obrigatório, da conversa): “O primeiro nome de quem está ligando.”
  • family_name (string, da conversa): “O sobrenome de quem está ligando, se tiver sido informado.”
  • phone_numbers (array, obrigatório, da conversa): “Exatamente um item, para o número de telefone de quem está ligando.” Em Each item, escolha object e adicione dois campos:
    • number (string, obrigatório, da conversa): “O número de telefone de quem está ligando.”
    • field (string, valor fixo): PHONE1
  • email_addresses (array, da conversa): “Exatamente um item, para o endereço de e-mail de quem está ligando. Omita se a pessoa não informar um.” Em Each item, escolha object e adicione dois campos:
    • email (string, obrigatório, da conversa): “O endereço de e-mail de quem está ligando.”
    • field (string, valor fixo): EMAIL1
  • owner_id (string, valor fixo): o ID de usuário que você anotou
  • leadsource_id (string, valor fixo): o ID da origem do lead, se quiser usar uma

Não adicione opt_in_reason ao endereço de e-mail. Isso marca o contato como inscrito para receber marketing, e uma confirmação verbal pode não ser considerada consentimento onde você e as pessoas que ligam estão.

A ferramenta sempre cria um novo contato. O Keap também pode atualizar um contato correspondente, mas isso pode substituir os números de telefone e endereços de e-mail já salvos nele, por isso este guia não usa essa opção.

Registre uma nota

CampoValor
Nomeadd_keap_note
Descrição”Registre no contato o que quem está ligando queria, antes de a chamada terminar.”
MétodoPOST
URLhttps://api.infusionsoft.com/crm/rest/v2/contacts/{contact_id}/notes
Cabeçalhos da solicitaçãoAuthorization (Secret): Bearer seguido do seu token
Parâmetros de caminhocontact_id (string, obrigatório, da conversa): “O id do contato de find_keap_contact ou create_keap_contact.”
Parâmetros do corpouser_id (string, valor fixo): o ID de usuário que você anotou
type (string, valor fixo): Call
title (string, obrigatório, da conversa): “Um título curto, por exemplo: Chamada de Jane Doe sobre um orçamento.”
text (string, obrigatório, da conversa): “O que quem está ligando queria, em algumas frases.”
Atribuir a agentesRecepcionista

No Keap Classic, defina type como um dos tipos de nota configurados pelo administrador ou omita-o.

Crie uma tarefa de acompanhamento

CampoValor
Nomecreate_keap_task
Descrição”Crie uma tarefa de acompanhamento para a equipe sempre que você prometer retornar a ligação.”
MétodoPOST
URLhttps://api.infusionsoft.com/crm/rest/v2/tasks
Cabeçalhos da solicitaçãoAuthorization (Secret): Bearer seguido do seu token
Parâmetros do corpoassigned_to_user_id (string, valor fixo): o ID do usuário que cuida dos retornos de ligação
title (string, obrigatório, da conversa): “Por exemplo: Retornar a ligação de Jane Doe sobre um orçamento.”
description (string, da conversa): “O nome, número de telefone e o que a pessoa precisa.”
contact_id (string, da conversa): “O id do contato de find_keap_contact ou create_keap_contact.”
due_time (string, da conversa): “Quando a equipe deve retornar a ligação, como data e hora no formato ISO 8601, por exemplo 2026-06-21T11:00:00Z.”
Atribuir a agentesRecepcionista

O proprietário, o usuário da nota e a pessoa designada para a tarefa são valores fixos, portanto, os novos registros sempre vão para as pessoas que você escolheu.

Adicione uma regra instruindo sua recepcionista a usar o Keap apenas para reconhecer quem está ligando e nunca ler de volta os detalhes de um contato.

Selecione Enable em cada ferramenta e, em seguida, teste sua recepcionista como uma nova pessoa ligando que pede um retorno. O contato, uma nota e uma tarefa aparecerão no Keap.

Opção 2: Zapier

1

Conecte o Zapier

Se ainda não fez isso, conecte o Zapier no Reception.ai.

2

Adicione as ações do Keap

No seu servidor MCP do Zapier em mcp.zapier.com, adicione as ações abaixo e conecte sua conta do Keap. Para cada campo, defina um valor fixo ou deixe a IA preenchê-lo, conforme listado.

3

Atribua as ferramentas

No Reception.ai, abra a aba Tools da integração do Zapier, selecione Refresh tools e atribua cada ação conforme listado.

4

Teste

Teste sua recepcionista como uma nova pessoa que liga pedindo retorno. O contato, uma nota e uma tarefa aparecem no Keap.

Ações do Zapier

Encontre quem está ligando

CampoValor
Ação do ZapierFind Contact
Definir no ZapierField: o campo usado na busca, como e-mail ou telefone.
Deixar a IA preencherValue: o endereço de e-mail ou número de telefone de quem liga.
Atribuir aClient

Adicione ou atualize quem está ligando

CampoValor
Ação do ZapierCreate or Update Contact
Definir no ZapierCheck for Duplicates Using (por exemplo, e-mail), a origem do lead, o responsável e quaisquer tags.
Deixar a IA preencherNome, sobrenome, endereço de e-mail e número de telefone.
Atribuir aClient

Não defina o opt-in do contato a partir de uma chamada, a menos que tenha certeza de que um sim verbal conta como consentimento de marketing onde você e as pessoas que ligam estão.

Registre uma nota

CampoValor
Ação do ZapierCreate Note
Definir no ZapierType, por exemplo, uma nota da chamada.
Deixar a IA preencherContact Id (da ação anterior), Title e Body.
Atribuir aClient

Crie uma tarefa de acompanhamento

CampoValor
Ação do ZapierCreate Task
Definir no ZapierUser Id: o membro da equipe que cuida dos retornos.
Deixar a IA preencherTitle, Due Date, Description e Contact Id.
Atribuir aClient

Para iniciar uma campanha do Keap para novas pessoas que ligam, adicione a ação Tag Contact com a tag da campanha definida como um valor fixo.

Independentemente da opção usada, adicione um procedimento para que sua recepcionista primeiro procure quem está ligando e só crie um contato quando nenhuma correspondência for encontrada.

Limitações

  • Este guia não verifica disponibilidade nem agenda compromissos, então sua recepcionista não pode marcar reuniões no Keap. Use a tarefa de acompanhamento ou o agendamento próprio do Reception com o Google Calendar.
  • create_keap_contact adiciona um novo contato sempre, e a opção Create or Update Contact do Zapier só identifica duplicatas pelo campo que você escolheu. Uma pessoa que liga e não é encontrada, ou que fornece um novo endereço de e-mail, pode ser adicionada duas vezes.
  • Com o Zapier, cada ação executada pela sua recepcionista usa tarefas do seu plano do Zapier. Atualmente, o Zapier contabiliza duas tarefas por chamada bem-sucedida; chamadas com falha não são contabilizadas. Quando o plano acaba, as ações param até ele ser renovado.

Solução de problemas

ProblemaO que verificar
401 do KeapInicie o valor do cabeçalho com Bearer e um espaço e verifique se a chave não foi excluída em API Settings.
400 ao adicionar um contatoO contato precisa de um número de telefone ou endereço de e-mail, e owner_id deve ser um ID de usuário da sua conta.
Uma ação do Keap não aparece no Reception.aiSelecione Refresh tools na integração do Zapier depois de adicionar ações no Zapier.
Uma ação mostra Changed e não é usadaVocê a editou no Zapier. Selecione Update na aba Tools.
Pessoas conhecidas que ligam não são encontradasO Keap compara os valores como estão armazenados. Pesquise por e-mail ou armazene números de telefone em um único formato.
Notas ou tarefas não estão vinculadas a quem ligaSua recepcionista precisa do ID do contato da ferramenta de busca ou criação, ou de Find Contact ou Create or Update Contact no Zapier.