# 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="/files/stNYt75BM14fPcB4IEs8" 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="/files/BTKkRrZoU1E3oQFwaKYn" 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/)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.rvops.com/central-de-ajuda-rvops-crm/conta-e-configuracao/integracoes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.