Передача — це частина роботи
Асистент, який закінчує словом «готово!», виконав половину задачі. Друга половина — два посилання й одне речення.
Що повертається людині
Два посилання, завжди. Адреса сторінки, щоб побачити саму річ. І claim-посилання, якщо акаунт provisional, бо це посилання і є акаунт: відкрити його й задати пошту з паролем — ось що робить сторінку його, а не чимось, що програма тримає від його імені.
API повертає готове повідомлення з обома, одним читабельним реченням. Вставте його або напишіть своє, але не надсилайте саму адресу: людина, яка так і не відкриє claim-посилання, лишиться зі сторінкою, яку не може правити, і без розуміння, що могла б.
- Скажіть, що сторінка вже працює. Люди припускають, що щось іще в процесі, і чекають на друге повідомлення.
- Скажіть одним підрядним, що робить claim-посилання: задає вашу пошту й пароль і робить акаунт вашим.
- Скажіть строк. Тридцять днів, а якщо мине — можна видати нове.
- Скажіть, що лишається у вас. Якщо тримаєте API-ключ для супроводу сторінки, скажіть про це і про те, як його відкликати.
Правила, що захищають обидві сторони
- Віддавайте claim-посилання лише тій людині, для якої сторінка. Це не посилання «поділитися», це ключі.
- Ніколи не кладіть його на сторінку, у біо, у публічний репозиторій чи у спільний чат.
- Не забирайте акаунт самі «щоб усе нормально налаштувати». Акаунт, забраний складальником, — акаунт, який власникові доведеться випрошувати.
- Якщо посилання витекло, видайте нове: випуск нового claim-посилання миттєво гасить старе.
Як зрозуміти, що дійшло
Статус claim-посилання переходить із pending у claimed, а whoami повідомляє, що акаунт більше не provisional. Агент, у якого лишився ключ, може перевіряти раз на день протягом тижня і нагадати людині, якщо нічого не сталося; це краще застосування автоматизації, ніж ще одна сторінка, якої ніхто не просив.
За всім цим стоїть ще й строк. Сторінка, яку ніхто не забрав і ніхто жодного разу не відкрив, знімається з публікації через тридцять днів і видаляється через шістдесят. Нагадування на двадцять п’ятий день коштує одного повідомлення і рятує роботу.