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, los detalles del pago y la información de envío.
Contenido
Carga útil de la plantilla
Para obtener una lista de todas las propiedades de este tipo de 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 obtener toda la información sobre la solicitud y sus propiedades, consulta la referencia de las plantillas 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
Mantén a las personas informadas de forma continuada. Una vez entregado el recibo, envía actualizaciones periódicas con la confirmación del envío y la entrega.
No utilices la plantilla de recibo para transmitir información no relacionada con compras. Esta plantilla solo debe utilizarse para confirmar una transacción anterior.