# Integrações

### Quando usar API vs Webhook

* **API (pull/consulta/ação)**: quando seu sistema **precisa buscar dados** na Rvops ou **executar ações** (criar/atualizar objetos, disparar automações, etc.).
* **Webhook (push/eventos)**: quando você **quer ser notificado automaticamente** sempre que algo acontecer (ex.: novo contato, mudança de fase, ticket resolvido, mensagem recebida, evento de automação executado).

> Dica: combine ambos — use **webhooks** para reagir a eventos em tempo real e **APIs** para consultar detalhes adicionais quando necessário

### Chaves de API

#### O que são

Chaves de API são credenciais secretas que autenticam chamadas da sua aplicação aos endpoints da Rvops. Trate-as como senhas.

#### Como criar/excluir

1. Acesse **Configurações > Integrações > API Tokens**.
2. Clique em **Criar Token**.
3. Defina o **nome.**
4. **Copie a chave** (não será exibida novamente).
5. Para **excluir**, localize a chave na lista e selecione **Excluir**.

> **Boas práticas**: use uma chave por aplicação/ambiente (prod, staging)

<figure><img src="https://1015224206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F11iNqUe1kJ00ErWHvme9%2Fuploads%2FLneWSnO5Q1Wm4qw8MAHq%2Fimage.png?alt=media&#x26;token=9fdb189d-0511-48ef-9bbd-11a92037c1b5" alt=""><figcaption></figcaption></figure>

**Boas práticas:**

* **Não exponha** a chave em front-end, repositórios públicos ou prints.
* **Rotacione** periodicamente (ex.: a cada 90 dias) ou se houver suspeita de vazamento.

{% hint style="warning" %}
**Limite de Requisições:** 100 requisições a cada 10 segundos.
{% endhint %}

**Quer iniciar a construção das suas integrações? Acesse nossa documentação em** [**https://developers.rvops.com/**](https://developers.rvops.com/)

### Webhooks

#### Como funcionam

Webhooks enviam **requisições HTTP POST** para sua URL quando um **evento** ocorre na Rvops. Você configura quais eventos deseja assinar.

#### Eventos disponíveis

* Contato → criação, atualização ou exclusão.
* Negócio → criação, atualização ou exclusão.
* Empresa → criação, atualização ou exclusão.
* Tarefa → criação, atualização ou exclusão.

#### Como configurar no CRM

1. Acesse **Configurações > Integrações > Webhooks**.
2. Clique em **Adicionar webhook**.
3. Informe **Nome, URL do endpoint (HTTPS) e eventos**&#x20;
4. Salve e teste.&#x20;

<figure><img src="https://1015224206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F11iNqUe1kJ00ErWHvme9%2Fuploads%2F7aYAD86yOB2zfmmySxWp%2Fimage.png?alt=media&#x26;token=a1caec24-b88e-447b-b19c-23e3c4a57dad" alt=""><figcaption></figcaption></figure>

**Quer iniciar a construção das suas integrações? Acesse nossa documentação em** [**https://developers.rvops.com/**](https://developers.rvops.com/)