FieldPulse | ElevenLabs Documentation

Com as ferramentas de webhook abaixo, sua recepcionista pode reconhecer pessoas que ligam e já estão no FieldPulse, adicionar novas pessoas como leads e deixar um comentário no cadastro do cliente com o que elas precisam, para que sua equipe possa fazer o acompanhamento.

Antes de começar

O FieldPulse fornece chaves de API mediante solicitação. Entre em contato com o suporte do FieldPulse pelo e-mail support@fieldpulse.com ou pelo chat no aplicativo e solicite uma chave de API. Todas as ferramentas abaixo a enviam no cabeçalho de solicitação x-api-key.

A chave de API pode ler e alterar seus dados do FieldPulse. Guarde-a em segurança e não a compartilhe.

Crie as ferramentas

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

Encontrar uma pessoa que ligou

Campo	Valor
Nome	`find_fieldpulse_customer`
Descrição	”Encontre a pessoa que ligou na nossa lista de clientes pelo nome ou número de telefone. Use no início de uma ligação sobre um serviço.”
Método	GET
URL	`https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`
Cabeçalhos da solicitação	`x-api-key`: sua chave de API
Parâmetros de consulta	`search` (string, obrigatório): “O nome completo ou número de telefone da pessoa que ligou.”

Adicionar um novo cliente

Campo	Valor
Nome	`create_fieldpulse_customer`
Descrição	”Adicione a pessoa que ligou como novo cliente quando `find_fieldpulse_customer` não a encontrar.”
Método	POST
URL	`https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`
Cabeçalhos da solicitação	`x-api-key`: sua chave de API
Parâmetros do corpo	`first_name` (string, obrigatório): “O primeiro nome da pessoa que ligou.” `last_name` (string, obrigatório): “O sobrenome da pessoa que ligou.” `phone` (string, obrigatório): “O número de telefone da pessoa que ligou, incluindo o código de área.” `email` (string): “O endereço de e-mail da pessoa que ligou, caso ela tenha informado um.” `status` (string, obrigatório): “Sempre o valor exato `lead`.” `service_address_1` (string): “O endereço onde o serviço é necessário.” `service_address_city` (string): “A cidade desse endereço.” `service_address_state` (string): “O estado.” `service_address_zip_code` (string): “O CEP.”

Registrar os detalhes da ligação

Campo	Valor
Nome	`add_fieldpulse_comment`
Descrição	”Deixe um comentário no cadastro do cliente da pessoa que ligou com o que ela precisa. Use quando tiver o ID do cliente.”
Método	POST
URL	`https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/comments`
Cabeçalhos da solicitação	`x-api-key`: sua chave de API
Parâmetros do corpo	`commentable_type` (string, obrigatório): “Sempre o valor exato `customer`.” `commentable_id` (number, obrigatório): “O ID do cliente, de `find_fieldpulse_customer` ou `create_fieldpulse_customer`.” `text` (string, obrigatório): “O que a pessoa que ligou precisa, quando está disponível e como entrar em contato com ela.”

Selecione Ativar em cada ferramenta e, em seguida, teste sua recepcionista como uma nova pessoa que liga precisando de um reparo. O cliente aparecerá no FieldPulse como lead, com o comentário da sua recepcionista.

Adicione um procedimento para novos serviços: encontre a pessoa que ligou, adicione-a se não for encontrada e registre os detalhes da ligação.

Limitações

Os serviços precisam de um tipo de serviço, um status e detalhes de cobrança da sua conta do FieldPulse, por isso sua recepcionista não os cria. Sua equipe transforma o lead em um serviço.
Sua recepcionista não pode verificar a disponibilidade de técnicos nem agendar um horário.
As ferramentas de webhook não podem enviar listas, então elas não podem adicionar tags ou campos personalizados a um cliente.

Solução de problemas

Problema	O que verificar
401 do FieldPulse	O cabeçalho deve se chamar `x-api-key` e conter uma chave atual.
400 do FieldPulse	Leia a lista de erros na resposta. `status` deve ser exatamente `lead`, e os números de telefone devem ser válidos.
Pessoas conhecidas que ligam não são encontradas	O FieldPulse busca correspondências com base no que está armazenado. Tente usar o nome da pessoa, além do número de telefone.
O comentário não é adicionado	`commentable_id` deve ser o ID de um cliente existente. Verifique se a ferramenta de busca ou criação foi executada primeiro.
429 do FieldPulse	Você atingiu o limite de solicitações do FieldPulse. Aguarde e tente novamente.