€7.99 + VAT
The International Telegram is the service for sending paper telegrams to any country in the world within seconds. The service is available 24/7.
The International Telegram service allows you to send real-time communications worldwide. All via API.
With International Telegrams, you can send paper telegrams to one or more recipients, both private and corporate, in any country in the world via API.
POST /telegrammi/
To send an international telegram, you need to use the same endpoint used for sending to Italy POST /telegrammi/ and provide information such as:
{
"data": {
"mittente": {
"ragione sociale": "openapi spa",
"dug": "piazza",
"indirizzo": "cavour",
"civico": "43",
"comune": "roma",
"cap": "00121",
"provincia": "rm",
"email": "[email protected]",
"nazione": "IT"
},
"destinatari": [
{
"nome": "string",
"cognome": "string",
"indirizzo": "string",
"comune": "string",
"cap": "string",
"provincia": "ee",
"nazione": "string",
"id": "664228bbbf1239901b0815f2",
"state": "NEW"
}
],
- "documento": [
"XX XXXXXX XXXXXXXXXXXXXXX XXXXX XXXXXXXX XXXXXXXXX XXXXXXXXX XXXXX XXXXXXXX XXX, XX XXXXXXXX XXXXX X XXX XXXXX XX XXXXXXX XXX 18 XXXXX 2023,XXXXXXX XX XXXXX XX XXXXXXX XXXXXX"
],
- "opzioni": {
"autoconfirm": false,
"mittente": false,
"ricevuta": false
}
}
}
In this case, the required data for the recipient is slightly different: the dug fields (e.g., avenue) and house number should be entered directly in the address field, and the province will always be "ee"
In the International Telegram, the sender's name is automatically included in the message text and counted in the calculation of the final price.
At the time of the request, it is also possible to select a series of options:
It is also possible to set automatic confirmation (autoconfirm) and thus send the shipment automatically (if the value is "true"). In this case, the cost of the shipment will be immediately charged, and its sending will be scheduled.
If you wish to check the shipping data and associated costs before sending, autoconfirm should be set to false.
The cost of the International Telegram is calculated based on the zone, words, and options.
POST /telegrammi/
The response will include all the information about the sender, the recipient, and the message, plus detailed cost information and the ID needed for sending confirmation.
{
"data": {
"mittente": {
"ragione sociale": "openapi spa",
"dug": "piazza",
"indirizzo": "cavour",
"civico": "43",
"comune": "roma",
"cap": "00121",
"provincia": "rm",
"email": "[email protected]",
"nazione": "IT"
},
"destinatari": [
{
"nome": "string",
"cognome": "string",
"indirizzo": "string",
"comune": "string",
"cap": "string",
"provincia": "ee",
"nazione": "string",
"id": "664228bbbf1239901b0815f2",
"state": "NEW"
}
],
- "documento":
"XX XXXXXX XXXXXXXXXXXXXXX XXXXX XXXXXXXX XXXXXXXXX XXXXXXXXX XXXXX XXXXXXXX XXX, XX XXXXXXXX XXXXX X XXX XXXXX XX XXXXXXX XXX 18 XXXXX 2023,XXXXXXX XX XXXXX XX XXXXXXX XXXXXX",
"opzioni": {
"autoconfirm": false,
"mittente": false,
"ar_c": false,
"ar_e": false,
"timestamp_invio": 1627659712
},
"prodotto": "international telegram",,
"creation_timestamp": 1627659712,
"update_timestamp": 1627659712,
"username": "[email protected]",,
"confirmed": true,,
"state": "CONFIRMED",
"documento_validato": {
"pdf": "https://ws.ufficiopostale.com/Up/pdf/test-document.pdf",
"jpg": "https://ws.ufficiopostale.com/Up/jpg/test-document.jpg",
"parole": 1,
"txt": "L",
"size": 1
},
"pricing": {
"dettaglio": [
{
"codice_servizio": "words",
"descrizione_servizio": "Postal rate words",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 4.27,
"importo_unitario_netto": 3.5,
"importo_unitario_iva": 0.77
},
{
"codice_servizio": "PRINT",
"descrizione_servizio": "Printing cost",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
},
{
"codice_servizio": "ENVELOPE",
"descrizione_servizio": "Envelope stuffing",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
}
],
"totale": {
"importo_totale_netto": 7,
"importo_totale_iva": 1.54,
"importo_totale": 8.54
}
},
"lock": false,
"confirmed_timestamp": 1627659712,
"id": "61041dc0ac2b1f63327e92d2"
}
},
"success": true,
"message": "",
"error": null
}
PATCH /telegrammi/
To confirm the shipping of the International Telegram, a second request using the PATCH method is required, where the ID of the previously made request must be transmitted.
The response will include all the data of the International Telegram with the status "confirmed"
International Telegrams are handed over to the national postal service provider on the same day, while delivery to the recipient is according to the local postal system times.
Do you need help?
Haven't found the answer you're looking for?
Fill in all the details, we will get back to you as soon as possible!
The International Telegram service allows you to send paper telegrams worldwide in just a few seconds, available 24/7. Thanks to API integration, it enables urgent and legally valid communications to one or more recipients, whether individuals or businesses, in any country.
Yes, you can schedule the sending of the telegram by specifying a custom timestamp. This allows you to plan the exact date and time when you want the telegram to be sent, providing greater flexibility for managing your communications in advance without worrying about real-time sending.
Yes, you can request a receipt of sending to have official confirmation that the telegram was successfully transmitted. The receipt certifies the time and date of sending, and it is particularly useful for documenting the delivery in situations where formal proof is required for legal or administrative purposes.
The International Telegram service is designed for a variety of users who need to send urgent and formal communications globally. Some ideal users include:
International telegrams are handed over to the national postal operator on the same day, while delivery to the recipient will take place according to the timeframes set by the local postal system.
Yes, it is available 24 hours a day, 7 days a week.
Starting from €7.23 + VAT. The price then changes depending on the zone, the number of words, and the options.