> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrar um CRM personalizado ou interno com a CloudTalk

> Ligue um CRM personalizado ou interno à CloudTalk através da REST API, de Webhooks, da Automação de fluxo de trabalho ou de uma ponte sem código como o Zapier…

<Note>
  A CloudTalk não tem um conector integrado para todos os CRM. Se criou o seu próprio sistema ou utiliza uma plataforma que não consta da nossa lista de integrações nativas, pode mesmo assim ligá-lo à CloudTalk. Este artigo explica os caminhos suportados.
</Note>

**Nível de utilizador**: Admin

***

<h2 id="h_11b71a1c7b">
  Antes de começar
</h2>

O acesso à API está disponível no **plano Essential e superiores**. Para saber onde encontrar as suas chaves e como gerá-las, consulte [Como aceder e gerar as suas chaves da API da CloudTalk.](/pt/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys) Se não vir o separador **Chaves da API** no seu Dashboard, a sua conta está provavelmente num plano inferior. Em caso de dúvida, contacte o Suporte da CloudTalk e nós verificamos por si.

<h2 id="h_635fbfead1">
  Opção 1: integração direta com a REST API (para programadores)
</h2>

A CloudTalk disponibiliza uma REST API pública que lhe permite ler e escrever dados de forma programática, incluindo contactos, chamadas e gravações.

1. Gere as suas credenciais de API: vá a **Conta > Definições > Chaves da API** e clique em **+ Adicionar chave de API**. Copie o Access Key ID e o Access Key Secret.

2. Envie os pedidos para a API em **api.cloudtalk.io**, utilizando autenticação Basic (o seu Key ID como nome de utilizador e o seu Secret como palavra-passe). Tenha em atenção que este endereço é diferente de [developers.cloudtalk.io](/developers) (a documentação) e de [dashboard.cloudtalk.io](https://dashboard.cloudtalk.io/) (o Dashboard), por isso certifique-se de que os seus pedidos são enviados para api.cloudtalk.io.

3. Consulte os endpoints disponíveis e os formatos de pedido em **[developers.cloudtalk.io](/developers)**.

4. Crie no seu CRM a lógica que chama estes endpoints nos eventos que lhe interessam, por exemplo criar ou atualizar um contacto depois de uma chamada terminar.

<Warning>
  **Dica:** Teste os seus pedidos numa ferramenta como o Postman antes de os ligar ao seu CRM. Utilize a opção Authorization > Basic Auth e cole o seu Key ID e o seu Secret. Esteja atento aos cabeçalhos de resposta do limite de pedidos e abrande se os atingir; os limites atuais estão documentados em [developers.cloudtalk.io](/developers).
</Warning>

<h2 id="h_58791abb69">
  Opção 2: receber eventos em tempo real com Webhooks (para programadores)
</h2>

Os Webhooks enviam os eventos da CloudTalk para um endpoint HTTPS que lhe pertence no momento em que acontecem, para que o seu CRM se mantenha sincronizado sem consultar a API repetidamente. Os eventos abrangem chamadas, contactos, utilizadores, mensagens, Conversation Intelligence, VoiceAgents e Dialer. Cada evento chega como JSON assinado.

1. Vá a **Conta > Webhooks** e clique em **Adicionar endpoint**. Precisa da função de Admin.

2. Introduza o seu URL HTTPS e escolha os tipos de evento que pretende. Deixe a seleção vazia para receber todos os eventos, incluindo os que forem adicionados mais tarde.

3. Copie o segredo de assinatura do endpoint e verifique a assinatura em cada entrega.

4. Clique em **Send test event** e confirme que o seu endpoint responde com um 2xx. Verá o resultado no registo de entregas.

As entregas falhadas são repetidas automaticamente e pode reenviá-las ou recuperá-las na mesma página durante um máximo de 30 dias. Para payloads, verificação de assinatura e boas práticas, consulte o [guia de Webhooks para programadores](/guides/webhooks/overview).

<h2 id="h_0e615ae39c">
  Opção 3: enviar eventos para o seu CRM com a Automação de fluxo de trabalho
</h2>

Se quiser que a CloudTalk envie dados para o seu CRM automaticamente quando algo acontece (por exemplo, quando uma chamada termina), pode configurar uma Automação de fluxo de trabalho que envia um pedido HTTP para um endpoint que controla.

1. No seu CRM, ou num servidor que controla, configure um endpoint capaz de receber pedidos HTTP POST.

2. Na CloudTalk, vá a **Conta > Automações de fluxo de trabalho** e crie uma automação acionada pelo evento que pretende, adicionando uma ação que envie um pedido HTTP para o URL do seu endpoint. Consulte o [guia das Automações de fluxo de trabalho](/pt/articles/5450779-configuring-workflow-automations) para a configuração.

3. A CloudTalk envia os dados do evento para o seu endpoint quando o acionador dispara.

4. Analise o payload no seu CRM para atualizar registos, registar chamadas ou desencadear ações de seguimento.

<Tip>
  **Bom saber:** Os pedidos HTTP da Automação de fluxo de trabalho são entregues com base no melhor esforço. Se o seu endpoint estiver temporariamente inacessível, uma entrega pode falhar e não existe reenvio em autosserviço. Se precisar de uma entrega de eventos fiável, com novas tentativas e reenvio, utilize antes os Webhooks (Opção 2).
</Tip>

<h2 id="h_089c28fdc5">
  Opção 4: ponte sem código através do Zapier ou do Make
</h2>

Se preferir não escrever código, o Zapier e o Make podem funcionar como ponte entre a CloudTalk e o seu CRM. Ambos suportam a CloudTalk como acionador e como origem de ações.

**Zapier:** Siga o guia [Configurar o Zapier](/pt/articles/3410740-configure-zapier) para ligar a sua conta CloudTalk e, em seguida, crie um Zap acionado por um evento da CloudTalk que envie dados para o seu CRM, através de uma ação nativa do CRM ou de um passo de webhook.

**Make (anteriormente Integromat):** Adicione a aplicação CloudTalk no Make (consulte a documentação da CloudTalk no Make em [apps.make.com/cloudtalk](https://www.make.com/en/integrations/cloudtalk)) e, em seguida, construa um cenário acionado por um evento da CloudTalk, como uma nova chamada, que mapeie os campos para o seu CRM. A aplicação CloudTalk no Make inclui uma ação genérica «Make an API Call», por isso, se o seu CRM não for uma aplicação nativa do Make, ou se precisar de uma operação da CloudTalk sem módulo dedicado, pode mesmo assim aceder a qualquer endpoint da CloudTalk através desse passo.

Ambas as ferramentas suportam passos personalizados de webhook/HTTP, pelo que até um CRM que não seja uma aplicação nativa em nenhuma das plataformas pode receber dados.

<h2 id="h_9b237ff688">
  Que opção é a mais indicada para mim?
</h2>

| | **REST API** | **Webhooks** | **Automação de fluxo de trabalho** | **Zapier / Make** |
| - | - | - | - | - |
| Requer programação | Sim | Sim (endpoint e verificação de assinatura) | Pouca (configuração do endpoint) | Não |
| Direção dos dados | Obtém os dados mediante pedido | A CloudTalk envia-os quando ocorre um evento | A CloudTalk envia-os quando ocorre um evento | Ambas |
| Ideal para | Leituras em massa, sincronização de contactos, controlo total | Fluxos de eventos em tempo real para o seu CRM ou ferramentas internas | Enviar eventos de chamada para o seu sistema | Configuração rápida, equipas sem programação |
| Garantia de entrega | Controla as novas tentativas | Novas tentativas automáticas, reenvio e recuperação durante 30 dias | Melhor esforço, sem reenvio em autosserviço | Depende da plataforma |

***

*Precisa de ajuda ou tem alguma questão?* Contacte-nos através do nosso [Portal de Suporte](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aqui para si.


## Related topics

- [Como importar contactos para a CloudTalk](/pt/articles/2145547-how-to-import-contacts-into-cloudtalk.md)
- [Utilizar a CloudTalk com o Pipedrive](/pt/articles/5360220-using-cloudtalk-with-pipedrive.md)
- [Usar a CloudTalk com o Zoho](/pt/articles/5375783-using-cloudtalk-with-zoho.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.