From 743389f905e560a40699e23801bb31609f8f54a0 Mon Sep 17 00:00:00 2001
From: Rafael Alves Lopes <rafael.lopes@sothis.com.br>
Date: Wed, 27 May 2026 16:46:42 -0300
Subject: [PATCH] Adicionar Contatos

---
 Contatos.md | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 Contatos.md

diff --git a/Contatos.md b/Contatos.md
new file mode 100644
index 0000000..84f8966
--- /dev/null
+++ b/Contatos.md
@@ -0,0 +1,34 @@
+# Contatos e Agenda
+
+Base tecnica:
+
+- Controller: `src/modules/admin/customer-contacts.controller.ts`
+- Service: `src/modules/admin/customer-contacts.service.ts`
+- Prefixo: `/contacts`
+
+## Responsabilidade
+
+Gerencia agenda e perfil de contatos usados no chat e na abertura ativa.
+
+## Endpoints
+
+| Metodo | Rota | Descricao |
+|---|---|---|
+| GET | `/contacts` | Lista agenda |
+| GET | `/contacts/:chatId` | Busca contato por chat/WhatsApp |
+| PUT | `/contacts/:chatId` | Cria ou atualiza contato |
+
+## Campos principais
+
+- `chat_id`: identificador WhatsApp, geralmente `5511999999999@c.us`.
+- `phone`: numero WhatsApp.
+- `call_sms_phone`: numero para ligacao/SMS.
+- `email`: email do contato.
+- `name`: nome.
+- `company`: campo historico usado como etiqueta de identificacao.
+- `note`: observacao.
+- `user_id`: usuario que salvou/atualizou.
+
+## Code review
+
+O nome tecnico `company` permaneceu por compatibilidade, mas na interface o conceito virou `Etiqueta de identificacao`.