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

# Conexão Universal

> Integre qualquer API HTTP/REST como canal de mensagens no Datacrazy

A **Conexão Universal** permite que você conecte qualquer serviço externo que possua uma API HTTP/REST como um canal de mensagens dentro do Datacrazy. Com ela, você pode enviar e receber mensagens de plataformas como Telegram, Discord, Slack, ou qualquer sistema proprietário que exponha endpoints HTTP.

## Como funciona

A Conexão Universal atua como uma ponte entre o Datacrazy e o serviço externo:

**Envio de mensagens:**

```
Datacrazy → Conexão Universal → API externa
```

O Datacrazy monta a requisição HTTP com base nos templates configurados, substitui as variáveis dinâmicas (contato, mensagem, anexos) e envia para a API do serviço externo.

**Recebimento de mensagens:**

```
API externa → Webhook → Datacrazy
```

O serviço externo envia os dados para uma URL de webhook fornecida pelo Datacrazy. A Conexão Universal extrai os campos necessários (remetente, mensagem, etc.) usando o mapeamento configurado.

***

## Criando uma Conexão Universal

1. No menu lateral, acesse **Configurações > Conexões**
2. Clique em **Nova Conexão** e selecione **Conexão Universal**
3. Preencha o campo **Nome da conexão** e, opcionalmente, escolha um ícone personalizado
4. Configure as abas conforme necessário:

| Aba             | Descrição                                                               |
| --------------- | ----------------------------------------------------------------------- |
| **Envio**       | URL base, endpoints, autenticação, credenciais e mapeamento de resposta |
| **Recebimento** | Mapeamento de campos do webhook, validação de assinatura e filtros      |
| **Logs**        | Histórico de requisições enviadas e recebidas (disponível após salvar)  |

5. Clique em **Finalizar** para salvar

Após a criação, um modal exibirá a **URL do Webhook** que deverá ser configurada no serviço externo para receber mensagens.

***

## Configuração mínima

Para uma conexão funcional, você precisa preencher no mínimo:

**Na aba Envio:**

* **URL Base** — endereço base da API externa (ex: `https://api.exemplo.com`)
* **Endpoint de Envio de Texto** — método, caminho e template do body
* **Mapeamento de Resposta** — caminhos para extrair o ID da mensagem e o status de sucesso

**Na aba Recebimento** (se desejar receber mensagens):

* Ativar **Habilitar recebimento de mensagens**
* Preencher o **Mapeamento de Campos** com os caminhos do payload

***

## Próximos passos

* [Enviando Mensagens](/universal-connection/sending-messages) — Configure endpoints, variáveis e mapeamento de resposta
* [Autenticação e Credenciais](/universal-connection/authentication) — Configure autenticação e variáveis reutilizáveis
* [Recebendo Mensagens](/universal-connection/receiving-webhooks) — Configure webhooks para receber mensagens
* [Exemplo: Telegram Bot](/universal-connection/example-telegram) — Integração completa passo a passo