Skip to content

Mettre à jour un message

post
https://api.reach.talkylabs.com/rest/messaging/v1/update

Cette opération permet de mettre à jour le corps d'un message. Elle est principalement utilisée pour expurger le contenu d'un message tout en laissant toutes les autres propriétés intactes.

Cette opération nécessite le messageId du message à mettre à jour. Elle nécessite également le body qui sera nouvellement associé au message. Pour mettre à jour plusieurs messages, cette opération doit être appelée autant de fois que nécessaire car elle ne peut mettre à jour qu'un seul message à la fois.

Note : Cette opération ne modifie pas le contenu du message déjà envoyé au destinataire. Elle ne fait que mettre à jour le "corps" du message dans la plateforme Reach.

Paramètres

  • messageIdstringrequired

    L'identifiant du message à mettre à jour.

  • bodystringrequired

    Le nouveau contenu à associer au message.

Exemple 1: Mettre à jour le contenu d'un message

curl -X POST https://api.reach.talkylabs.com/rest/messaging/v1/update --data-urlencode "messageId=MIDXXXXXXXXXXXXXX" --data-urlencode "body=A new message." -H "ApiUser: $REACH_TALKYLABS_API_USER" -H "ApiKey: $REACH_TALKYLABS_API_KEY"
Output example
{
  "appletId": "AIDXXXXXXXXXXXX",
  "apiVersion": "1.0.0",
  "body": "A new message.",
  "dest": "+237671234567",
  "src": "+237691234567",
  "numSegments": 1,
  "numMedia": 0,
  "price": 25,
  "priceUnit": "xaf",
  "messageId": "MIDXXXXXXXXXXXXXX",
  "status": "scheduled",
  "messageType": "outbound",
  "errorCode": null,
  "errorMessage": null,
  "dateCreated": "2016-08-29T09:12:33.001Z",
  "dateSent": null,
  "dateUpdated": "2016-08-29T09:12:35.001Z"
}

Exemple 2: Expurger le contenu d'un message

Dans cet exemple, nous allons expurger le contenu d'un message dont l'identifiant est spécifié. Pour ce faire, le contenu du message sera mis à "".

curl -X POST https://api.reach.talkylabs.com/rest/messaging/v1/update --data-urlencode "messageId=MIDXXXXXXXXXXXXXX" --data-urlencode "body=" -H "ApiUser: $REACH_TALKYLABS_API_USER" -H "ApiKey: $REACH_TALKYLABS_API_KEY"
Output example
{
  "appletId": "AIDXXXXXXXXXXXX",
  "apiVersion": "1.0.0",
  "body": "",
  "dest": "+237671234567",
  "src": "+237691234567",
  "numSegments": 1,
  "numMedia": 0,
  "price": 25,
  "priceUnit": "xaf",
  "messageId": "MIDXXXXXXXXXXXXXX",
  "status": "scheduled",
  "messageType": "outbound",
  "errorCode": null,
  "errorMessage": null,
  "dateCreated": "2016-08-29T09:12:33.001Z",
  "dateSent": null,
  "dateUpdated": "2016-08-29T09:12:35.001Z"
}