Учебник по отправке почтовых открыток, писем и проверок почтовой почтой с использованием LOB REST API с использованием PHP онлайн урок.


Содержание

Что такое Lob?

Зачем использовать Lob?

Услуги

Зачем использовать Lob?

Программист дружественный

Поддержка интеграции

Заключение


Что такое Лоб?

Lob - компания, основанная на предпринимательстве, основанная в Сан-Франциско, штат Калифорния, и имеющая более 6000 клиентов, включая Amazon, Square и Counsyl.

Они предоставляют решение для печати и рассылки на основе облачных вычислений. Основанная с целью предоставления более доступного и более простого обслуживания, чем создание собственного решения для печати.

Lob создан для разработчиков, чтобы предоставить им инструменты для создания мощных приложений и помочь масштабировать физическую рассылку для своих компаний.

План Lob заключается в том, чтобы устранить сложности прямой почтовой рассылки и предоставить вам более инновационную систему, в которой вы можете легко отслеживать почту, доставлять своих клиентов без необходимости преодолевать проблемы с бумажными замятиями или поездки на почтовое отделение.

Lob

Зачем использовать Lob?

Клиентская база Lob состоит из более чем 6000 компаний, которые варьируются от 500 000 компаний (например, Amazon) до стартапов и отдельных разработчиков. Если у вас есть Lob, интегрированный в вашу систему, вы можете сосредоточиться на своих клиентах, вместо того чтобы иметь дело с проблемами печати и рассылки.

Lob основан на оплате, поскольку вы потребляете модель. Таким образом, вы можете легко отправить 1 рассылку или 1 миллион за раз.

Физическая почта имеет более высокую скорость открытия, чем электронная почта. Вы можете не видеть его сейчас, но все больше и больше стартапов теперь переходят к физическому mail в качестве своего основного метода маркетинга.

Одно из выводов Эпсилона показывает, что «для каждых 1000 существующих клиентов, получающих кусок прямой почты, 34 будут реагировать в среднем. Для электронной почты средний ответ составляет 0,12%».

Теперь, если вы собираетесь адаптировать физическую почту в качестве своего маркетингового метода, какой лучший способ сделать, чем Lob, простое, богатое и доступное решение для рассылки печатной почты?

Услуги

Lob предоставляет ряд услуг, которые помогут вам расширить свой бизнес и лучше добираться до ваших клиентов. Ниже перечислены основные услуги, предоставляемые Lob.

Открытки

Используя Lob API, вы можете легко создать полностью настраиваемый шаблон открытки HTML. Затем вы можете отправлять персонализированные открытки для тестирования шаблонов или для любых конкретных действий, которые предпринимают ваши пользователи, или определенных событий, которые вы определяете. Или повторно активировать рецидивирующих пользователей.

Письма

Отправляйте письма своим пользователям так же легко, как отправка электронной почты. Вы можете генерировать каждое электронное письмо по требованию. Вы можете легко настроить букву для событий, которые вы определяете, или действия, которые предпринимают ваши пользователи.

Вы можете отправлять письма безопасно и быстро. Вы можете использовать API Lob для точной отправки каждого документа, гарантируя, что каждый документ предназначен только для глаз предполагаемого получателя.

Проверки

С помощью Lob вы можете доставлять чеки с различными настройками для поддержки, логотипа, информации о счетах, инструкциях и заметках и многое другое, чтобы сделать платежи максимально ясными.

Теперь с отправкой чеков безопасность должна быть, и никто не обеспечивает более безопасную систему доставки, чем Lob.

С API-интерфейсом Lob каждая проверка отправляется с цветным фоном, водяными знаками, границами с микропечати, термическими чернилами, которые исчезают при протирании, и кодированием Magnetic Ink Character Recognition (MICR) для облегчения обработки банка и уменьшения ошибок.

И так же важно, вы можете убедиться, что ваши чеки доставляются, отслеживая их прогресс в процессе рассылки.

Простая зональная почта

С Lob API вы можете легко настроить цели на все почтовые индексы с помощью открыток. Эта услуга особенно полезна для стартапов, чтобы их присутствие было известно будущим клиентам.

С помощью API Lob вы можете легко получить демографические данные на основе zip-кода, чтобы сделать свой кампания, даже более конкретная для точки возраста, дохода, а также разделения жилья и бизнеса. И вы можете сделать все это, не заплатив за какую-либо плату за установку, вы платите только за то, что вы отправляете.

Проверка адреса

Вы можете легко проверить почтовые адреса мгновенно с помощью Lob API, вы также можете стандартизировать адреса, чтобы гарантировать, что ваше письмо достигнет желаемого получателя. API использует данные непосредственно из USPS для исправления недостающей информации. И, кроме всего прочего, он бесплатный для всех внутренних адресов и очень доступный по международным адресам.

Couchsurfing, живое сообщество путешествий использует Lob для автоматизации всего, чтобы убедиться, что пользователь предоставляет получаемые адреса для окончательной проверки карточек подтверждения по требованию.

Прост в использовании

API Lob невероятно прост в использовании, предоставляя вам мощное и масштабируемое решение для рассылки. Лоб сделал отправку физической почты так же просто, как отправка электронной почты.

Вы можете легко отслеживать все свои письма. Вы можете настроить таргетинг на конкретные регионы и демографические данные для своей кампании. Служба API Lob очень похожа на API-интерфейс Sendgrid или Twilio. API Lob полностью избавляет от отправки почты и может быть интегрирован со многими внутренними приложениями.

Программист дружественный

Lob API чрезвычайно дружелюбен к программистам, он предлагает готовые обертки для нескольких языков программирования, таких как: Java, PHP, Node, Python и Ruby. Он также предоставляет

документацию для всех этих оболочек, с примером кода .

LOB documentation

Полная документация

также доступна для необработанных запросов API . Но здесь мы обсудим PHP-оболочку. Вы можете легко установить оболочку PHP с помощью композитора или получить его непосредственно из Github.

How Lob Works?

Теперь, чтобы начать, вы должны аутентифицировать все свои запросы и правильно пройти аутентификацию с помощью API Lob, ключ API должен быть отправлен в каждом запросе. Ниже приведен пример того, как инициировать оболочку с авторизацией:

$ apiKey = 'test_0dc8d51e0acffcb1880e0f19c79b2f5b0cc';
$ lob = new \ Lob \ Lob ($ apiKey);
Как вы можете видеть, довольно просто и просто использовать оболочку PHP.

Ошибки

Ниже приведен список ошибок HTTP-кода ответа HTTP и то, что среднее:

Lob ErrorsВ общем случае 2xx указывает на успех, 4xx указывает на ошибку ввода, а 5xx указывает на ошибку на конце Lob,

Webhooks

Webhooks - это действительно хорошая функция для отслеживания уведомлений о событиях, например, при каждом запуске события Lob немедленно отправит это событие на любой URL, указанный для этого события, на панели управления Lob.

Но сначала вы должны быть уверены, что подписались на мероприятие в среде (протестируете или живете).

Метаданные

При отправке запроса в API Lob вы можете прикреплять к нему метаданные, поэтому вы можете легко отфильтровать запросы позже. Ниже приведен пример того, как присоединить метаданные к запросу:

$ lob- & gt; postcards () - & gt; create (массив (

& nbsp; 'описание' & nbsp; & nbsp; & nbsp; = & gt; 'Demo Postcard job ',
& nbsp;' metadata [campaign] '= & gt;' NEWYORK2015 ',
& nbsp;' & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; = & gt; '& rbs; & nbsp; & nbsp; = & gt;' & rbs; & nbsp; & nbsp; & nbsp; = & gt; из '& nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; = & gt;' adr_61a0865c8c573139 ',
' front '& nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; «margin: 130px; font-size: 50;» & gt; Передний HTML для {{name}} & lt; html & gt; ',
& nbsp;' back '& nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; = & gt; & nbsp; & nbsp; & nbsp; & nbsp; = & gt;; & lt; html style = "margin: 130px; font-size: 50;" & gt; Назад HTML & lt; html & gt; ',
& nbsp;' data [name] '& nbsp; & nbsp; & nbsp; = & gt;' Harry '
));


Как вы можете видеть, вышеупомянутый запрос содержит метаданные с ключевой «кампанией». Теперь, чтобы отфильтровать запрос с указанием определенных метаданных, вы сделаете что-то вроде этого:
$ lob- & gt; postcards () - & gt; all (array (

'metadata [campaign]' & NBSP; = & GT; 'NEWYORK2015',

& nbsp; 'limit' & nbsp; & NBSP; & NBSP; & NBSP; & NBSP; & NBSP; & NBSP; = & GT; 2,
'offset' & nbsp; & NBSP; & NBSP; & NBSP; & NBSP; & NBSP; & NBSP; = & GT; 0
));


Использование
Ниже приведен пример кода для проверки почтовых адресов с использованием Lob API PHP-оболочки:

$ lob- & gt; addresses () - & gt; verify (array (

'address_line1' & nbsp; & nbsp; = & gt; 185 Berry Street ',

& nbsp;' address_city '& nbsp; & nbsp; = & gt;' & gt; 'Сан-Франциско',
& nbsp; 'address_state' & nbsp; = & gt; 'CA',
& nbsp; 'address_zip' & nbsp; & nbsp; & nbsp; = & gt; '94107'
));


Ниже приведен еще один пример кода, который показывает, как вы можете создавать открытки с помощью Lob API PHP-оболочки:
$ lob- & gt; postcards () - & gt; create (array (

'description' = & gt; 'Demo Postcard job ',

' to '& nbsp; & nbsp; & nbsp; & nbsp; = & gt;' adr_78c304d54912c502 ',
& nbsp;' from '& nbsp; & nbsp; & nbsp; = & gt;' adr_61a0865c8c573139 ',
& nbsp;' front '& nbsp; & nbsp; & nbsp; = & gt;' & lt; html style = "padding: 1in; font-size: 50;" & gt; Передний HTML для {{name}} & lt; html & gt; ',
& nbsp;' back ' & nbsp; & nbsp; & nbsp; = & gt; '& lt; html style = "padding: 1in; font-size: 20;" & gt; Назад HTML для данных {{name}} & lt; html & gt;',
& nbsp; [name] '& nbsp; = & gt;' Harry '
));


Значение для ключей массива «to» и «from» - это идентификаторы адресов, которые вы можете получить из API.
Вы можете получить список адресов из этого простого запроса:

$ lob- & gt; addresses () - & gt; all (array (

& nbsp; 'limit' & nbsp; = & gt; 2,

& nbsp; 'offset' & nbsp; = & gt; 1
));


Вышеупомянутый запрос будет содержать все данные, относящиеся к адресам, включая идентификатор адреса. Вы можете использовать метаданные в этом запросе для получения более конкретных результатов.
API Lob также предоставляет некоторые другие ресурсы, например:

$ lob- & gt; countries () - & gt; all ();

Используя этот запрос, вы можете получить список всех стран, которые вы можете использовать позже, чтобы добавлять адреса и т. Д.
Теперь, посмотрев приведенные выше примеры кода, вы можете ясно видеть, насколько просто использовать это API.

Отслеживать почту

С помощью API Lob вы можете отслеживать свои фрагменты почты на этом пути. Вы можете легко следить за своими открытками, письмами, чеками и документами на своем пути к предполагаемым получателям.

Вы можете отслеживать события отслеживания или добавлять уникальные промо-коды, URL-адреса или номера телефонов. Вы можете использовать webhooks, чтобы следить за своей почтой через почтовый поток с событиями отслеживания в реальном времени и доказательствами в формате PDF.

Ниже приведена разбивка каждого ярлыка события события и описание:

В Транзите

Почтовый ящик обрабатывается в месте происхождения объекта.

В локальной области

Почтовый ящик обрабатывается на объекте назначения.

Обработано для доставки

Почтовый ящик был включен в зеленый список для доставки в ближайшем почтовом учреждении получателя. Почтовый ящик должен доходить до почтового ящика в течение 1-2 рабочих дней после этого события сканирования.

Re-routed

Отправка почты перенаправляется из-за изменения адреса получателя, ошибок адреса или повторной маркировки идентификационной маркировки штрих-кода USPS.

Возврат отправителю

Отправка отправителя отправителю из-за штрих-кода, области идентификационной метки или ошибок адреса.

Поддержка интеграции

Для интеграции Lob API в ваше приложение, включая PHP, доступны различные обертки. Если вы хотите использовать другой язык, и обертка недоступна для этого языка, вы можете легко создать собственный SDK для своего приложения.

Lob также предлагает интеграцию через своих партнеров по интеграции, которые предлагают различные услуги самостоятельно. Если у вас есть учетная запись на своем сайте, вы можете интегрировать эти учетные записи в свою учетную запись на Lob, используя ключи API.

В Lob также есть некоторые партнерские приложения, предлагающие прямые почтовые решения на базе Lob. Вы можете начать работу с ними в приложениях, перейдя на страницу интеграции на сайте Lob.

Заключение

Lob

предоставляет несколько интересных услуг, которые необычны, поскольку они создают мост между онлайн-мир с услугами, которые должны предоставляться в физическом мире, например, печатные рассылки, которые будут доставлены через почтовую почту.

Надеюсь, эта статья станет хорошим началом для создания очень интересных приложений на основе служб, которые вы не знали, которые могут быть реализованы с использованием API REST.

Если вам понравилась эта статья, поделитесь ею с другими коллегами-разработчиками. Если у вас есть вопросы, напишите комментарий ниже.