레퍼런스

안 될 때 · 자주 묻는 질문

무엇이 왜 안 됐고 어떻게 하면 되는지. DM 과 자동화, 계정 연결, 발행, 네이버 블로그, 에이전트.

아래 답은 에이전트가 읽는 답과 같습니다. get_help 도구가 오류 코드나 짧은 질문으로 같은 글을 돌려주고, 여기 답이 있는 오류에는 error.help 에 그 주소가 실립니다.

받은 오류 코드나 일어나지 않은 일을 아래 절에서 찾아보세요.

DM 과 자동화

계정에 「DM 권한 재연결」 이 떠요

DM 과 댓글 자동화에는 연결된 계정에 Meta 메시지 권한이 있어야 합니다. Meta 가 그 권한을 승인한 2026년 10월 2일 전에 연결한 계정에는 그 권한이 없어서, 그 계정의 DM 과 자동화는 reconsent_required 로 답합니다.

대시보드 연결 화면에서 그 계정의 「재연결」 을 누르고 Meta 화면의 권한을 모두 허용해 주세요. 보낸 글, 자동화, 기록은 그대로 남습니다.

댓글 공감과 스레드 멘션이 「심사 중」 이에요

인스타그램 댓글 공감과 스레드 멘션 읽기에는 Meta 가 아직 심사하는 권한 두 개가 필요합니다. 심사가 끝나기 전에는 그 권한이 없는 계정에서 feature_in_review 로 답합니다.

지금은 다시 연결해도 달라지지 않습니다. 심사 중인 권한은 Meta 가 내주지 않기 때문입니다. 나머지는 모두 됩니다. 발행, 답글, 프라이빗 리플라이, DM, 다른 자동화가 그대로 돌고, 스레드 대댓글 자동화도 멘션 없이 돕니다.

첫 DM 은 갔는데 버튼을 누른 뒤의 DM 이 안 가요

매니챗 같은 다른 앱이 Meta 에서 그 대화의 주도권을 쥐고 있습니다. Meta 는 한 대화에 한 앱만 답하게 합니다. 댓글 단 사람에게 가는 첫 메시지는 프라이빗 리플라이라 어느 쪽이든 전달되지만, 버튼을 누른 뒤의 메시지는 일반 DM 이라 다른 앱이 대화를 쥐고 있는 동안 Meta 가 거절합니다. 자동화 실행 기록에 이 이유가 남습니다.

계정에 연결된 페이스북 페이지의 설정에서 바꿉니다. 인스타그램은 페이지 설정에서 Page setup, Instagram Conversation Routing 순서로 엽니다. 페이스북 메신저는 페이지 설정의 Conversation routing 입니다. 거기서 Uplika 를 기본 앱으로 정하거나, 이 페이지에서 다른 앱을 빼 주세요.

이 사람에게 DM 을 못 보내요

Meta 는 그 사람이 마지막으로 메시지를 보낸 뒤 24시간 안에만 비즈니스가 메시지를 보내게 합니다. 그 시간이 지나면 창이 닫혀 보내기는 window_closed 로 답하고, 자동화는 그 단계에서 멈춘 뒤 이유를 남깁니다.

그 사람이 계정에 메시지를 보내면 창이 다시 열립니다. 댓글은 창을 열지 않습니다. 댓글만 단 사람에게 닿는 길은 그 댓글에 보내는 프라이빗 리플라이 하나뿐입니다.

댓글에 DM 이 안 갔어요

댓글 단 사람에게 가는 첫 DM 은 프라이빗 리플라이입니다. Meta 는 댓글 하나에 프라이빗 리플라이를 한 번, 댓글이 달린 뒤 7일 안에만 허용합니다. 같은 댓글에 걸린 두 번째 자동화나 7일이 지난 댓글에는 보낼 수 없습니다.

같은 자동화는 한 댓글에 한 번만 답합니다.

스레드에서도 DM 을 보낼 수 있나요?

아니요. 스레드에는 메시지 API 가 없어서 Uplika 가 스레드 DM 을 보내거나 읽지 못합니다. 스레드의 자동화는 공개로 답합니다. 「댓글 → 대댓글」 자동화가 댓글 밑에 답하고, 계정 멘션은 그 권한의 Meta 심사가 끝나면 인박스에 보입니다.

페이스북에는 왜 「팔로우 확인」 이 없나요?

Meta 는 페이지에 메시지를 보낸 사람이 그 페이지를 좋아하거나 팔로우하는지 앱에 알려 주지 않습니다. 팔로우 확인은 인스타그램에서만 됩니다. 인스타그램은 대화를 연 사람이 계정을 팔로우하는지 알려 줍니다.

「원댓글에 공감」 이 잠겨 있어요

Uplika 는 네이버 블로그와, 페이스북을 거쳐 연결한 인스타그램 계정(페이스북 페이지에 연결된 계정)에서만 댓글에 공감할 수 있습니다. 다른 채널과 인스타그램 로그인으로 연결한 인스타그램 계정에서는 이 옵션이 잠기고 API 는 like_unavailable 로 답합니다.

인스타그램 공감은 아직 Meta 앱 심사 중이라 지금 다시 연결해도 풀리지 않습니다. 심사가 끝나면 인스타그램 계정을 페이스북을 거쳐 연결해 쓰실 수 있습니다.

자동화가 댓글에 반응하지 않아요. 무엇을 확인하나요?

자동화가 초안으로 남아 있지 않고 켜져 있는지 확인하세요. 어느 글을 보는지 확인하세요. 특정 글 하나, 다음 글, 모든 글 중 하나입니다. 키워드를 정했다면 댓글이 그 키워드에 맞아야 합니다.

연결된 계정이 직접 쓴 댓글에는 반응하지 않으니 다른 계정으로 시험하세요. 같은 자동화는 한 댓글에 한 번만 답합니다. 인박스에서 직접 답하면 그 대화에서는 자동화가 30분 동안 쉽니다.

계정에 「DM 권한 재연결」 이나 다른 재연결 안내가 떠 있으면 먼저 다시 연결하세요. 메시지 권한과 웹훅 구독이 없으면 Uplika 가 댓글을 받지 못합니다.

계정 연결

연결할 때 페이스북 페이지나 인스타그램 계정이 안 보여요

Meta 화면에서 Uplika 가 쓸 페이지를 고릅니다. 일부 페이지만 고르고 이 페이지를 빼면 Meta 가 우리에게 알려 주지 않습니다. 다시 연결하면서 그 페이지를 포함해 주세요.

페이지에 콘텐츠를 만들 수 있는 역할도 있어야 합니다. 페이스북을 거치는 인스타그램은 그 페이지에 연결된 프로페셔널 계정이어야 합니다.

같은 채널의 계정을 하나 더 연결할 수 없어요

워크스페이스 하나에는 채널마다 계정이 하나씩 붙습니다. 인스타그램 계정을 하나 더 쓰려면 워크스페이스를 새로 만들어 거기에 연결하세요. 워크스페이스마다 계정, 글, 자동화가 따로인 브랜드 하나입니다.

발행

글이 계속 「나가는 중」 이에요

발행은 비동기입니다. 글과 사진은 보통 몇 초 안에 끝납니다. 영상은 채널이 처리하는 동안 더 걸리고, 긴 유튜브 영상은 그보다 더 걸립니다. 네이버 블로그는 확장이 깔린 크롬을 기다립니다.

끝낼 수 없는 대상은 이유와 함께 실패로 끝나고, 「나가는 중」 에 계속 머물지 않습니다. 에이전트는 get_post 를 읽거나 publish 에 wait: true 를 넣어 글이 나갈 때까지 답을 기다리게 할 수 있습니다.

틱톡 글이 「나만 보기」 로 올라가요

틱톡은 콘텐츠 게시 감사를 통과하지 않은 앱이 올린 글을 만든 사람에게만 보이게 둡니다. Uplika 의 감사는 지금 검토 중입니다. 통과하기 전까지 틱톡 글은 「나만 보기」 로 올라가고, 공개 범위는 틱톡 앱에서 바꿀 수 있습니다.

네이버 블로그

네이버 블로그 글은 내 브라우저의 Uplika 크롬 확장이 씁니다. 확장이 깔린 크롬이 꺼져 있거나 컴퓨터가 잠들어 있으면 글이 기다렸다가 크롬이 다시 켜질 때 나갑니다. 최대 7일까지 기다립니다.

네이버 로그인이 풀렸다면 로그인 창이 뜹니다. 거기서 로그인하면 같은 글이 이어서 나갑니다.

Uplika 는 예약 시각에 글을 보내지만, 네이버 블로그 글은 확장이 쓰기 때문에 그 시각에 확장이 깔린 크롬이 켜져 있고 컴퓨터가 깨어 있어야 합니다. 그렇지 않으면 다음에 크롬이 켜질 때 나갑니다. 예약 한 시간 전에 확장이 꺼져 있으면 Uplika 가 메일로 알려 드립니다.

에이전트

에이전트가 workspace_required 를 받아요

워크스페이스가 둘 이상인데 호출이 어느 것인지 말하지 않았습니다. 오류에 워크스페이스 목록이 실려 옵니다. 도구에는 workspaceId 를, REST 에는 x-uplika-workspace 헤더를 넣어 주세요. 잘못 고르면 다른 브랜드 계정에 글이 올라가므로 Uplika 가 대신 고르지 않습니다.

에이전트가 Uplika 연결이 끊겼거나 권한이 없다고 해요

에이전트의 커넥터 설정에서 Uplika 를 다시 연결하세요. Uplika 로그인이 열리고 다시 허용을 묻습니다. 코덱스에서는 codex mcp login uplika 를 실행하세요.

대시보드 MCP 화면에서 그 에이전트를 지웠다면 접근이 끝난 것이라 새로 연결해야 합니다.

에이전트에서 읽기

get_help 는 code(오류 코드), query(어느 언어든 짧은 말), id, platform, locale 을 받습니다. 인자가 없으면 질문 목록을 줍니다. REST 로는 같은 답이 GET /v1/help 에 있고 키가 필요 없습니다.

GET/v1/help

오류 코드 · 질문 · id 로 찾는 문제 해결 답. 인증이 필요 없습니다.

쿼리 파라미터

이름타입설명
codequery오류 코드. 예: reconsent_required. 그 코드에 답하는 항목을 줍니다.
qquery어느 언어든 짧은 질문. 가장 잘 맞는 다섯 개를 줍니다.
idqueryid 로 답 하나. 예: thread-control.
platformquery그 채널의 답과 공통 답만.
categoryquerydm, connect, publish, naver, agent 중 하나.
localequeryen(기본) 또는 ko.
curl "https://api.uplika.com/v1/help?code=reconsent_required"