---
id: helper-braziliancontacthelper
title: Helper — BrazilianContactHelper
description: Formatação de telefones brasileiros locais, com DDD e com DDI 55.
type: technical-reference
status: implemented
visibility: public
tags: sge/helpers, sge/contato, sge/formatacao
related: helper-digitshelper, helper-funcoes-globais
source_refs: https://github.com/sge-suite/sge/blob/master/app/Helpers/BrazilianContactHelper.php, https://github.com/sge-suite/sge/blob/master/tests/Unit/Helpers/FormattingHelpersTest.php
---
## Responsabilidade

Formata números brasileiros com 8 a 13 dígitos. Valores de 12 ou 13 dígitos que não começam em `55` são devolvidos sem máscara para não transformar telefones internacionais incorretamente.

| Tamanho | Formato |
| --- | --- |
| 8/9 | Número local |
| 10/11 | DDD brasileiro |
| 12/13 iniciando em `55` | DDI `+55` e DDD |

Entrada vazia retorna `-`; tamanho não reconhecido retorna o valor original.

## Checklist

- [x] Implementar formatos local, DDD e DDI 55.
- [x] Preservar números internacionais não brasileiros.
- [x] Expor `formatPhone()` como fachada global.
- [ ] Cobrir todos os tamanhos e casos inválidos em testes unitários diretos.

## Relacionamentos

- [Helper — DigitsHelper](doc:helper-digitshelper)
- [Funções globais](doc:helper-funcoes-globais)