텔레그램 연락처 추가 안됨: 동기화·검색 설정·계정 제한 구분하기
텔레그램 연락처 추가가 안 된다면 먼저 휴대폰 주소록에 번호가 있는지, 앱이 연락처에 접근할 수 있는지, 현재 계정에서 동기화를 사용하는지 확인하세요. 특정 사람만 보이지 않는다면 번호 정확성과 상대의 전화번호 검색 설정도 살펴봐야 합니다. 검색 결과가 없다는 이유만으로 미가입이나 차단을 단정할 수는 없습니다.
고객 번호를 저장했는데 목록에 나타나지 않는 상황과, 프로필은 열리지만 저장이 실패하는 상황은 확인할 단계가 다릅니다. 본인 소유 또는 확인에 동의한 연락처 하나로 어디까지 되는지 살펴보세요. 제한 안내가 나타났다면 반복해서 가져오기보다 표시된 안내를 확인하고, 고객이 직접 제공한 현재 사용자명이나 기존 대화로 계정을 확인하는 편이 명확합니다.
1. 어떤 단계에서 안 되는지 먼저 나누세요
“연락처 추가가 안 된다”는 표현만으로 원인을 찾기는 어렵습니다. 전체 목록이 비어 있는지, 특정 고객만 없는지, 프로필을 열고 저장하는 순간 실패하는지부터 구분하세요. 휴대폰 주소록에 저장된 이름과 텔레그램에 표시되는 계정 이름이 다를 수 있으므로 이름 검색 하나만으로 결과를 판단하지 마세요.
오류가 있다면 문구와 발생한 동작을 함께 기록하세요. “번호를 입력한 뒤 결과 없음”과 “이미 열린 프로필에서 저장 실패”는 다른 기록입니다. 이후 설정을 하나씩 확인하면 어느 변경이 영향을 주었는지 이해하기 쉽습니다. 여러 계정을 번갈아 시험하거나 같은 번호를 계속 검색해서 원인을 추측할 필요는 없습니다.
| 증상 | 먼저 확인할 것 | 단정하지 말아야 할 것 |
|---|---|---|
| 목록 전체가 안 보임 | 선택한 계정·연락처 권한·동기화 | 모든 번호가 미가입이라는 판단 |
| 특정 사람만 안 보임 | 번호 정확성·상대의 발견 설정 | 상대가 나를 차단했다는 판단 |
| 프로필은 열리지만 저장 실패 | 저장 동작의 오류·제한 안내 | 번호 검색 실패와 같은 원인이라는 판단 |
| 저장 후 메시지 전송 실패 | 메시지 단계의 별도 안내 | 저장하면 발송도 보장된다는 판단 |
2. 휴대폰 권한·동기화·번호 표기를 확인하세요
우선 텔레그램에서 현재 선택한 계정이 맞는지 확인하고, 휴대폰 기본 주소록에서 해당 연락처를 열어보세요. 다른 계정의 주소록을 보고 있거나 예전 번호가 남아 있으면 앱 설정을 바꾸어도 기대한 계정을 찾기 어렵습니다. 연락처를 새로 여러 개 만드는 대신 기존 항목의 번호와 중복 여부부터 점검하세요.
운영체제의 앱 권한에서 텔레그램의 연락처 접근 상태를 확인하세요. 기기에서 허용한 범위와 앱 내부의 연락처 동기화 상태는 별도로 살펴봐야 합니다. 메뉴 이름은 운영체제와 앱 버전에 따라 다를 수 있습니다. 동기화는 기기 주소록과 연결되는 기능이므로 어떤 연락처를 제공하는지 이해한 뒤 설정하세요.
번호는 국가번호를 포함한 정확한 국제 형식인지 확인하세요. 앞자리나 국가번호를 임의로 조합해 다른 번호를 찾아보지 말고, 고객이 제공한 현재 번호와 비교하면 됩니다. 공식 앱이 최신인지 확인한 뒤 앱을 종료하고 다시 열어보세요. 데이터 삭제나 재로그인을 첫 조치로 삼기보다 현재 설정과 오류를 먼저 확인하는 편이 좋습니다.
- Android: 설정 → 앱 → Telegram → 권한에서 연락처 또는 주소록 접근을 확인하세요. 제조사와 운영체제 버전에 따라 메뉴 이름이 다를 수 있습니다.
- iPhone: 설정 → 개인정보 보호 및 보안 → 연락처 → Telegram에서 접근 범위를 확인하세요.
- 연락처 접근이 제한되어 있다면 확인하려는 고객 연락처가 선택되어 있는지 살펴보세요. 전체 주소록 접근을 허용할 필요는 없으며, 기기의 접근 범위와 앱 내부의 동기화 상태는 구분해서 확인하세요.
3. 번호로 찾기와 열린 프로필 저장은 별개입니다
휴대폰에 전화번호를 저장하는 일, 그 번호로 텔레그램 사용자를 찾는 일, 이미 확인한 프로필을 텔레그램 연락처에 저장하는 일은 같은 동작이 아닙니다. 예를 들어 고객이 직접 보내준 사용자명 링크로 대화는 열리는데 번호 검색에서는 나오지 않을 수 있습니다. 이때는 번호 검색이 실패했다는 사실과 현재 프로필을 확인했다는 사실을 따로 기록하세요.
고객이 알려준 사용자명이나 프로필 링크, 기존 대화가 있다면 현재 상대 계정이 맞는지 그 경로에서 확인할 수 있습니다. 다만 사용자명을 발견했다는 것만으로 새 메시지를 원한다는 뜻은 아닙니다. 프로필 저장 기능 역시 계정에 적용된 제한을 면제한다는 근거가 되지 않습니다. 상대에게 개인정보 설정 변경을 요구하지 않고도 가능한 연락 경로를 함께 확인하세요.
4. 검색 결과가 없다고 미가입은 아닙니다
전화번호를 누가 볼 수 있는지와 전화번호로 누가 나를 찾을 수 있는지는 구분해서 생각해야 합니다. 텔레그램 공식 문서는 개인정보 설정에 따라 가입한 연락처도 번호 가져오기 결과에 모두 나타나지는 않을 수 있다고 설명합니다. 따라서 목록에서 보이지 않는 번호를 곧바로 미가입 목록으로 확정하면 안 됩니다.
일반 사용자는 화면의 안내와 고객이 직접 제공한 현재 계정을 중심으로 확인하면 됩니다. 외부 도구를 사용하는 담당자라면 아래 정의도 구분하세요. 도구에 표시된 코드나 목록은 그 동작의 결과이며, 상대의 가입 상태·차단 여부·메시지 수신 가능성을 한꺼번에 증명하는 값이 아닙니다.
| 도구의 항목 | 의미와 해석 주의 |
|---|---|
| contacts.importContacts | 전화번호를 포함한 연락처 가져오기. 개인정보 설정 때문에 가입 계정이 모두 반환되지는 않을 수 있습니다. |
| contacts.addContact | 이미 식별한 텔레그램 사용자를 연락처로 저장하는 동작. 제한 면제를 뜻하지 않습니다. |
| contacts.resolvePhone의 PHONE_NOT_OCCUPIED | 번호에 연결된 계정이 없거나 상대의 개인정보 설정이 번호 조회를 막을 때 같은 오류가 나올 수 있습니다. |
| retry_contacts | 서버 측 시스템 제한으로 가져오지 못한 항목. 가져오기 성공 목록과 구분해야 합니다. |
5. 제한이나 보류 안내가 있다면 반복하지 마세요
가져오기가 보류되었거나 계정 제한 안내가 보이면, 그 상태를 성공이나 미가입으로 바꾸어 기록하지 마세요. 현재 앱 또는 사용 중인 도구의 안내를 보존하고 공식 도움말을 확인하세요. 공식 모바일 앱에서 주소록을 동기화한다는 사실만으로 연락처 추가 제한이 보편적으로 해제되는 것은 아닙니다.
고객에게 확인할 때는 “현재 텔레그램에서 사용하는 사용자명이나 기존 대화를 알려주실 수 있나요?”처럼 필요한 경로만 물어보면 됩니다. 다른 경로도 고객이 제공하거나 이용하기로 한 경우에 사용하세요. 제한이 잘못 적용됐다고 판단된다면 공식 지원 경로를 확인하고, 숫자로 된 보편적 안전 한도나 반복 가져오기를 해결책으로 삼지 마세요.
6. 고객에게 연락하기 전 확인표
담당자에게 전달할 기록은 간단하면 됩니다. 선택한 계정, 고객에게 확인한 번호, 현재 열리는 대화 경로, 실패한 동작과 안내를 정리하세요. 기록을 공유해야 한다면 불필요한 전화번호나 계정 정보를 함께 노출하지 마세요. 원인 확인에 필요한 사실과 추측을 구분하면 다음 담당자도 같은 검사를 되풀이하지 않을 수 있습니다.
여러 번호의 확인 결과를 해석해야 한다면 텔레그램 번호 목록 확인 가이드를 참고하세요. PSYKE 텔레그램 번호 검수는 지원하는 번호 확인 결과를 살펴보는 기능이며, 연락처 등록·전화번호 검색 설정 해제·메시지 발송 기능을 제공한다는 뜻은 아닙니다. 연락 경로를 확인한 뒤 실제 공지와 응대를 준비할 때는 텔레그램 메시지 운영 가이드로 이어가면 됩니다.
연락처 저장은 메시지 발송 권한이나 전달 보장이 아니며, 공식 스팸 FAQ에서 말하는 “상대가 내 번호를 저장한 경우”와 “내가 상대 번호를 저장한 경우”는 다릅니다.
- 현재 로그인한 계정과 휴대폰 주소록을 확인했나요?
- 접근 권한과 앱 동기화 상태를 각각 확인했나요?
- 검색 실패와 프로필 저장 실패를 구분했나요?
- 제한 안내를 보존하고 미확인 결과를 따로 남겼나요?
자주 묻는 질문
텔레그램에 가입한 사람인데 연락처에 안 뜨는 이유는 무엇인가요?
기기 접근 권한, 동기화 상태, 번호 정확성, 상대의 번호로 발견되기 설정 등을 구분해서 확인해야 합니다. 보이지 않는다는 사실만으로 미가입이나 차단을 단정하지 말고 상대가 직접 제공한 현재 프로필을 확인하세요.
공식 모바일 앱에서 동기화하면 연락처 추가 제한이 풀리나요?
그렇게 보장할 수 없습니다. 주소록 동기화와 계정에 적용된 제한은 별개로 확인하고, 반복 가져오기 대신 실제 안내와 공식 지원 경로를 살펴보세요.
retry_contacts에 있는 항목은 추가된 것인가요?
가져오기 성공 목록이 아닙니다. 공식 정의상 서버 측 시스템 제한으로 가져오지 못한 연락처 항목이므로 성공과 분리해야 합니다.