Invia messaggi transazionali | Convos

Le campagne transazionali ti permetteranno di inviare comunicazioni o notifiche ai tuoi clienti in tempo reale quando si verifica un evento nei tuoi processi e sistemi.

Requisiti:

Il tuo X-Tenant.
https://help.convos.la/it/articles/8452332-x-tenant
Un token con l’abilità "Campagne".
https://help.convos.la/it/articles/8306556-token-di-accesso
L’ID di una campagna transazionale. Creane una se non lo hai già fatto.

Configurazione della richiesta:

Descrizione	Invia un messaggio transazionale.
HTTP Method	POST
Headers	X-Tenant: {YourXTenant} Authorization: Bearer {YourToken}
URL	https://api.convos.la/consumer/transactional-campaigns/{CampaignId}/send
JSON request (esempio)	{ "phone": "+5491122220000", "name": "John", "product": "SEGURO DE HOGAR", "link": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf" }
JSON request (esempio con allegato)	{ "phone": "+5491122220000", "name": "John", "product": "SEGURO DE HOGAR", "link": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf", "attachment": { "type": "<File type>", "filename": "<File name>", "content": "<File in base 64 encoded>" } }
JSON response (esempio)	{ "message": "sent" }
Paginación y filtrado (esempio)	*none*
Parametri aggiuntivi	Campo: try_fix_cellphone: true\|false Descrizione: Questo parametro consente di correggere automaticamente il numero di telefono quando non è in formato internazionale, in modo che il messaggio possa essere inviato correttamente. { "try_fix_cellphone": true }

Dove ottenere il CampaignId:

Dall'API:
Ottenere l'elenco delle campagne transazionali.
Dalla piattaforma:
Lo troverai nell'elenco delle campagne, ognuna con il proprio ID.

Il numero di telefono:

Per inviare un messaggio tramite WhatsApp è necessario il numero di telefono completo del cliente (incluso il prefisso internazionale).

Invio di allegati:

Per inviare un allegato, assicurati che la campagna transazionale abbia un template configurato per l’invio di contenuti multimediali. Nella chiamata API, dovrai aggiungere una key attachment con i valori type e content, specificando il tipo e il contenuto dell’allegato. Il contenuto deve essere codificato in base64.

Tipi di file supportati: pdf, png, jpg, jpeg, doc, docx, mp4.

Esempio:

{
  "attachment": {
    "type": "<File type>",
    "filename": "<File name>",
    "content": "<File in base 64 encoded>"
  }
}