Plantilla de recibo
La plantilla de recibo te permite enviar una confirmación de pedido como un mensaje estructurado. La plantilla puede incluir un resumen del pedido, detalles del pago y la información de envío.
Índice
Carga de plantilla
Para ver una lista completa de las propiedades de la plantilla, consulta la referencia de la plantilla de recibo.
"payload": {
"template_type":"receipt",
"recipient_name":"<CUSTOMER_NAME>",
"order_number":"<ORDER_NUMBER>",
"currency":"<CURRENCY_CODE>",
"payment_method":"<PAYMENT_METHOD_USED>",
"order_url":"<LINK_TO_ORDER_SUMMARY>",
"timestamp":"<ORDER_TIME_AS_POSIX_TIMESTAMP>",
"address":{
"street_1":"<SHIPPING_STREET_ADDRESS>",
"city":"<SHIPPING_CITY>",
"postal_code":"<SHIPPING_POSTAL_CODE>",
"state":"<SHIPPING_STATE>",
"country":"<SHIPPING_COUNTRY>"
},
"summary":{
"subtotal": <SUBTOTAL_AMOUNT>,
"shipping_cost": <SHIPPING_AMOUNT>,
"total_tax": <TAX_AMOUNT>,
"total_cost": <TOTAL_AMOUNT>
},
"adjustments":[
{
"name": "<ADJUSTMENT_NAME>",
"amount": <ADJUSTMENT_AMOUNT>
},
...
],
"elements":[
{
"title": "<ITEM_NAME>",
"subtitle":"<ITEM_DESCRIPTION_OR_DETAILS>",
"quantity": <QUANTITY>,
"price": <ITEM_PRICE>,
"currency": "<CURRENCY_ABBREVIATION",
"image_url":"<URL_IMAGE_TO_DISPLAY_FOR_ITEM>"
},
...
]
}Ejemplo de solicitud
Para ver las propiedades y los detalles completos de la solicitud, consulta la referencia de la plantilla de recibo.
curl -X POST -H "Content-Type: application/json" -d '{
"recipient":{
"id":"<PSID>"
},
"message":{
"attachment":{
"type":"template",
"payload":{
"template_type":"receipt",
"recipient_name":"Stephane Crozatier",
"order_number":"12345678902",
"currency":"USD",
"payment_method":"Visa 2345",
"order_url":"http://petersapparel.parseapp.com/order?order_id=123456",
"timestamp":"1428444852",
"address":{
"street_1":"1 Hacker Way",
"street_2":"",
"city":"Menlo Park",
"postal_code":"94025",
"state":"CA",
"country":"US"
},
"summary":{
"subtotal":75.00,
"shipping_cost":4.95,
"total_tax":6.19,
"total_cost":56.14
},
"adjustments":[
{
"name":"New Customer Discount",
"amount":20
},
{
"name":"$10 Off Coupon",
"amount":10
}
],
"elements":[
{
"title":"Classic White T-Shirt",
"subtitle":"100% Soft and Luxurious Cotton",
"quantity":2,
"price":50,
"currency":"USD",
"image_url":"http://petersapparel.parseapp.com/img/whiteshirt.png"
},
{
"title":"Classic Gray T-Shirt",
"subtitle":"100% Soft and Luxurious Cotton",
"quantity":1,
"price":25,
"currency":"USD",
"image_url":"http://petersapparel.parseapp.com/img/grayshirt.png"
}
]
}
}
}
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"Ejemplo de respuesta
{
"recipient_id": "1254477777772919",
"message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}
Prácticas recomendadas
Informa continuamente a las personas. Después de entregar el recibo, envía actualizaciones oportunas con información del envío y la entrega.
No utilices la plantilla de recibo para transmitir información que no esté relacionada con compras. Usa esta plantilla únicamente para confirmar una transacción previa.