> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # FieldPulse Com as [ferramentas de webhook](/docs/pt/reception-ai/integrations/webhooks) 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](mailto: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`. > **Warning** > > 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](/docs/pt/reception-ai/receptionist/testing) como uma nova pessoa que liga precisando de um reparo. O cliente aparecerá no FieldPulse como lead, com o comentário da sua recepcionista. > **Tip** > > Adicione um [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures) 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. |