Lob
[Lob.com][38] est un service en ligne qui vous permet d’envoyer un publipostage à vos utilisateurs.
L’intégration Braze et Lob exploite les webhooks Braze et l’API Lob pour envoyer des courriers tels que des lettres, des cartes postales et des chèques par la poste.
Conditions préalables
| Condition | Description |
|---|---|
| Compte Lob | Un compte Lob est nécessaire pour bénéficier de ce partenariat. |
| Clé API de Lob | Votre clé API de Lob se trouve dans la section des paramètres, sous votre nom, dans le tableau de bord de Lob. |
Intégration
Étape 1 : Sélectionnez l’endpoint de Lob
L’URL HTTP à demander dans le webhook est différente pour chaque action que vous pouvez effectuer sur Lob. Dans l’exemple suivant, nous utilisons l’endpoint de l’API d’envoi de cartes postales https://api.lob.com/v1/postcards. Consultez la [liste complète des endpoints]][39] pour sélectionner l’endpoint qui convient à votre cas d’utilisation.
| Point d’extrémité de l’API | Endpoints disponibles |
|---|---|
| https://api.lob.com/ | /v1/addresses /v1/addresses/{id} /v1/verify /v1/postcards /v1/postcards/{id} /v1/letter /v1/letter/{id} /v1/checks /v1/checks/{id} /v1/bank_accounts /v1/bank_accounts/{id} /v1/bank_accounts/{id}/verify /v1/areas /v1/areas/{id} /v1/routes/{zip_code} /v1/routes /v1/countries /v1/states |
Étape 2 : Créez votre modèle de webhook Braze à Braze
Pour créer un modèle de webhook Lob à utiliser dans de futures campagnes ou Canvases, naviguez vers Modèles > Modèles de webhook dans la plateforme Braze.
Si vous utilisez l’ancienne navigation, allez dans Engagement > Modèles et médias > Modèles de webhook.
Si vous souhaitez réaliser une campagne webhook à Braze unique ou utiliser un modèle existant, sélectionnez Webhook à Braze lors de la création d’une nouvelle campagne.
Dans votre nouveau modèle de webhook, remplissez les champs suivants :
- URL de webhook :
<LOB_API_ENDPOINT> - Corps de la requête : Texte brut
En-têtes de requête et méthode
Lob nécessite un en-tête HTTP pour l’autorisation et une méthode HTTP. Ce qui suit sera déjà inclus dans le modèle en tant que paire clé-valeur, mais dans l’onglet Paramètres, vous devez remplacer le <LOB_API_KEY> par votre clé API Lob. Cette clé doit comporter un “ : “ directement après la clé et être codée en base 64.
- Méthode HTTP : POST
- En-têtes de la requête :
- Autorisation: De base
<LOB_API_KEY>: - Content-Type: application/json
- Autorisation: De base
Corps de la requête
Voici un exemple de corps de requête pour l’endpoint Lob postcards. Bien que ce corps de requête soit fourni dans le modèle de base Lob de Braze, si vous souhaitez utiliser d’autres endpoints, vous devez ajuster vos champs Liquid en conséquence.
1
2
3
4
5
6
7
8
9
10
"description": "Demo Postcard",
"to": {
"name": "{{${first_name}}} {{${last_name}}}",
"address_line1": "{{custom_attribute.${address_line1}}}",
"address_city": "{{custom_attribute.${address_city}}}",
"address_zip": "{{custom_attribute.${address_zip}}}",
"address_country": "{{custom_attribute.${address_country}}}"
},
"front": "https://lob.com/postcardfront.pdf",
"back": "https://lob.com/postcardback.pdf"
Étape 3 : Prévisualisez votre requête
À ce stade, votre campagne devrait être prête à être testée et envoyée. Consultez le tableau de bord de Lob et les journaux des messages d’erreur de la console de développement de Braze si vous rencontrez des erreurs. Par exemple, l’erreur suivante a été provoquée par un en-tête d’authentification mal formaté.
N’oubliez pas d’enregistrer votre modèle avant de quitter la page !
Les modèles de webhook mis à jour se trouvent dans la liste Modèles de webhook enregistrés lors de la création d’une nouvelle campagne webhook.
Il y a [38]: https://lob.com Il y a [39]: https://lob.com/docs#intro Il y a [40]: https://lob.com/docs#auth
Modifier cette page sur GitHub