由于企業微信23年12月改版,導致很多服務的企業不能使用非本公司備案的域名回調,必須使用服務商代開發應用功能解決,然而官方文檔過于晦澀難懂,此文即為代開發應用的踩坑記錄,如果能幫到你,那就非常好,歡迎點贊~
代開發應用流程介紹
- 創建代開發應用模板
- 提交應用上線
- 獲取授權碼,此時授權碼不能直接找人授權,必須先開發一個特殊功能,遇到過來的create_auth請求,一定要記錄下來,否則無法進行后續步驟。如果忘了記錄保存,可以讓對應企業取消授權,重新授權獲取。
- 拿到create_auth請求里面的
auth_code
參數,調用官方接口換成永久授權碼permanent_code。對,這個auth_code是一次性的,千萬記得保存permanent_code - permanent_code就是應用的secret,然后拿到crop_id開始開發應用
- 代開發的應用上線,一定要先上線,否則授權信息還是拿不到。上線和普通流程一樣,crop_id、permanent_code、token和aesKey這幾個換access_token
- 申請更改代開發應用權限,改到想要的信息記錄去
以下就是一些踩坑記錄
-
代開發應用的secret在哪兒找??
我最開始看文檔也看懵了,沒找到具體位置。看起來很隱蔽,實際上確實一點也不明顯。位置在代開發應用模板的,查看模板信息這里。
代開發應用secret
模板secret -
怎么獲取代開發應用模板的access_token?
文檔地址:https://developer.work.weixin.qq.com/document/path/97162
上一步的模板id就是suit_id,模板secret就是suit_secret,至于ticket,是企微官方每10分鐘推送到模板應用接口的,拿到了就可以進行下一步了。 -
怎么獲取代開發應用的access_token?
文檔地址:https://developer.work.weixin.qq.com/document/path/97164
secret就是上文拿到的permanent_code
-
代開發應用拿不到數據?
檢查是否授權或者請求了授權,如果沒有授權就請求授權。
編輯代開發應用需要的權限 -
獲取代開發的suit_token報錯 ip not allow
{'errcode': 60020, 'errmsg': 'not allow to access from your ip:client 1.1.1.1'}
服務商必須在管理后臺添加IP白名單,多個ip之間用分號隔開。具體位置企微后臺->服務商信息->ip白名單
服務商信息
IP白名單設置 -
提示員工user_id無效、添加/刪除/編輯好友沒有回調?
在第三方的企業,還需要在應用界面,修改可見范圍,改為全公司。這步很重要