> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.cooby.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Lógica de correspondência de números de telefone no Salesforce

O Cooby conecta automaticamente contatos do WhatsApp aos registros do Salesforce, verificando o número salvo no campo *Phone*. Isso garante que suas conversas no WhatsApp sejam vinculadas ao registro correto no Salesforce.

O comportamento de correspondência varia dependendo do uso do **Country Selector** no Salesforce. Os cenários abaixo explicam como o Cooby determina as correspondências, com tabelas centralizadas para facilitar a leitura.

### Cenário A: Country Selector ativado 
Quando o Country Selector está ativado, os números no Salesforce podem ser salvos em **formato local** (sem código do país). O Cooby aplica automaticamente o código correto com base no selector.
| Contato WhatsApp | Telefone no Salesforce | Country Selector ativo? | Resultado | Observação |
| ---- |
| +16501234567 | 6501234567 | ✅ | ✅ Match | Código do país adicionado pelo selector |
| +442012341234 | 02012341234 | ✅ | ✅ Match | Selector completa o código ausente |
Com o selector ativado, os números no Salesforce não precisam incluir código do país. O Cooby usa o selector para identificar e corresponder corretamente os contatos.

### Cenário B: Country Selector não utilizado
Sem o Country Selector, os números devem estar em **formato E.164** (por exemplo, +16501234567). Se o número não tiver código do país, o Cooby não poderá fazer a correspondência.
| Contato WhatsApp | Telefone no Salesforce | Country Selector ativo? | Resultado | Observação |
| ---- |
| +16501234567 | +16501234567 | ❌ | ✅ Match | Ambos incluem código do país |
| +16501234567 | 6501234567 | ❌ | ❌ No match | Ausência de código do país |
Quando o selector não é utilizado, os números precisam incluir o código do país para que o Cooby possa reconhecê-los.

### Cenário C: Contatos previamente desvinculados manualmente
Se um contato foi manualmente desvinculado, o Cooby **não** fará o vínculo automático novamente, mesmo que os números correspondam.
| Contato WhatsApp | Telefone no Salesforce | Country Selector ativo? | Resultado | Observação |
| ---- |
| +16501234567 *(desvinculado anteriormente)* | (650)1234567 | — | ⛔ Não vinculado automaticamente | O desvínculo manual prevalece |
Desvínculos manuais substituem toda a lógica automática. Para vincular novamente, é necessário fazer o relink manual no Cooby.

### Cenário D: Números com formatações diferentes
Diferenças de formatação (espaços, parênteses, hífens) não afetam a correspondência desde que o código do país e o número sejam os mesmos.
| Contato WhatsApp | Telefone no Salesforce | Country Selector ativo? | Resultado | Observação |
| ---- |
| +442012341234 | +44 20 1234 1234 | ❌ | ✅ Match | Diferenças de formatação ignoradas |
O Cooby ignora formatações e analisa apenas o valor numérico (incluindo o código do país).

### Pontos importantes
* Com o **Country Selector ativo**, números podem ser salvos em formato local.
* Sem o selector, utilize o **formato E.164**.
* Contatos manualmente desvinculados **não serão** vinculados automaticamente.
* Você pode fazer o relink manual sempre que necessário.

Esperamos que este documento ajude você a entender melhor como o Cooby funciona. Se tiver dúvidas ou perguntas sobre sua integração com o Salesforce, entre em contato conosco pelo e-mail support@cooby.co 💜