In questo tutorial impareremo come utilizzare Ultramsg Nodejs-WhatsApp-sdk per utilizzare WhatsAppAPI con Nodejs<\/p>\n\n
npm i ultramsg-whatsapp-api<\/code><\/code><\/pre>\n\nEsempio di utilizzo<\/h2>\n\nconst ultramsg = require('ultramsg-whatsapp-api');\nconst instance_id= \"instance1150\" \/\/ Ultramsg.com instance id\nconst ultramsg_token= \"tof7lsdJasdloaa57e\" \/\/ Ultramsg.com token\nconst api = new ultramsg(instance_id,ultramsg_token);\n(async function () {\n var to = \"put_your_mobile_number_here\"\n var body = \"Hello world\" \n const response = await api.sendChatMessage(to,body);\n console.log(response)\n})(); <\/code><\/pre>\n\nNOTA:<\/strong> devi sostituire instance_id e token con il tuo nell’account ultramsg.com se non hai un account creane uno da qui<\/a> .<\/p><\/blockquote>\n\nInvia messaggio<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar body=\"Hello world\";\nvar priority=10;\nvar referenceId=\"SDK\";\nconst response = await api.sendChatMessage(to,body,priority,referenceId);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- a<\/b> : il tuo numero per il test con formato internazionale es. +14155552671 o chatID per contatti o gruppi es. 14155552671@c.us o 14155552671-441234567890@g.us<\/li>
- corpo<\/strong> : testo del messaggio, stringa UTF-8 o UTF-16 con emoji.<\/li>
- priorit\u00e0:<\/strong> questo parametro \u00e8 facoltativo,<\/li><\/ul>\n\n
Puoi usarlo per creare una coda professionale per i messaggi<\/a> , i messaggi con un valore di priorit\u00e0 inferiore vengono inviati per primi.<\/p>\n\nesempio di utilizzo:<\/p>\n\n
priorit\u00e0 = 0: per priorit\u00e0 alta come i messaggi OTP.<\/p>\n\n
priorit\u00e0 = 5: utilizzato con messaggi generali.<\/p>\n\n
priorit\u00e0 =10: offerte promozionali non urgenti e notifiche ai tuoi clienti.<\/p>\n\n
Valore predefinito:<\/strong> 10<\/p>\n\n- referenceId<\/strong> : il tuo ID di riferimento<\/a> personalizzato per questo messaggio.<\/li><\/ul>\n\n
Invia immagine<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar caption=\"image Caption\"; \nvar image=\"https:\/\/file-example.s3-accelerate.amazonaws.com\/images\/test.jpg\"; \nvar priority=10;\nvar referenceId=\"SDK\"\nvar nocache=false; \nconst response = await api.sendImageMessage(to,caption,image,priority,referenceId,nocache);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- didascalia<\/strong> : didascalia dell’immagine, stringa UTF-8 o UTF-16 con emoji.<\/li>
- image<\/strong> : immagine del collegamento HTTP o file con codifica base64<\/li><\/ul>\n\n
Estensioni supportate (jpg, jpeg, gif, png, svg, webp, bmp).<\/p>\n\n
Dimensione massima del file: 16 MB.<\/p>\n\n
Lunghezza massima Base64<\/a> : 2.000.000<\/p>\n\n- nocache<\/strong> : predefinito falso<\/li><\/ul>\n\n
false: utilizza un file precedentemente caricato invece di caricarlo con ogni richiesta<\/p>\n\n
true: caricandolo ogni richiesta<\/p>\n\n
Invia documento<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar filename=\"cv.pdf\"; \nvar document=\"https:\/\/file-example.s3-accelerate.amazonaws.com\/documents\/cv.pdf\"; \nconst response = await api.sendDocumentMessage(to,filename,document);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- nomefile:<\/strong> nome del file, ad esempio 1.jpg o Hello.pdf<\/li>
- documento:<\/strong> file di collegamento HTTP o file con codifica base64<\/li><\/ul>\n\n
Supporta la maggior parte delle estensioni come ( zip , xlsx , csv , txt , pptx , docx …. etc ) .<\/p>\n\n
Dimensione massima del file: 100 MB.<\/p>\n\n
Lunghezza massima Base64: 2.000.000<\/p>\n\n
Invia audio<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar audio=\"https:\/\/file-example.s3-accelerate.amazonaws.com\/audio\/2.mp3\"; \nconst response = await api.sendAudioMessage(to,audio);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- audio<\/strong> : audio del collegamento HTTP o audio con codifica base64<\/li><\/ul>\n\n
Estensioni supportate (mp3, aac, ogg).<\/p>\n\n
Dimensione massima del file: 16 MB.<\/p>\n\n
Lunghezza massima Base64: 2.000.000<\/p>\n\n
Invia voce<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar audio=\"https:\/\/file-example.s3-accelerate.amazonaws.com\/voice\/oog_example.ogg\"; \nconst response = await api.sendVoiceMessage(to,audio);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- audio<\/strong> : file ogg audio del collegamento HTTP con opus codec o file ogg base64 nel codec opus<\/li><\/ul>\n\n
Dimensione massima del file: 16 MB.<\/p>\n\n
Lunghezza massima Base64: 2.000.000<\/p>\n\n
Invia video<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar caption=\"video Caption\"; \nvar video=\"https:\/\/file-example.s3-accelerate.amazonaws.com\/video\/test.mp4\"; \nconst response = await api.sendVideoMessage(to,caption,video);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- video<\/strong> : video con collegamento HTTP o video con codifica base64<\/li><\/ul>\n\n
Estensioni supportate (mp4, 3gp, mov).<\/p>\n\n
Dimensione massima del file: 16 MB.<\/p>\n\n
Lunghezza massima Base64: 2.000.000<\/p>\n\n
<\/a><\/h2>\n\nInvia il link<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar link=\"https:\/\/ultramsg.com\"; \nconst response = await api.sendLinkMessage(to,link);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\ncollegamento: collegamento<\/strong> HTTP o HTTPS<\/p>\n\nInvia contatto<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar contact=\"14000000001@c.us\"; \nconst response = await api.sendContactMessage(to,contact);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- contatto:<\/strong> esempio di matrice Contact ID o Contact ID:<\/li><\/ul>\n\n
Esempio<\/p>\n\n
14000000001@c.us<\/p>\n\n
o<\/p>\n\n
14000000001@c.us,14000000002@c.us,14000000003@c.us<\/p>\n\n
Lunghezza massima: 300 caratteri, quasi 15 contatti<\/p>\n\n
Invia posizione<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar address=\"ABC company \\n Sixth floor , office 38\"; \nvar lat=\"25.197197\"; \nvar lng=\"55.2721877\"; \nconst response = await api.sendLocationMessage(to,address,lat,lng);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\n- indirizzo<\/strong> : Testo sotto la posizione.<\/li><\/ul>\n\n
Supporta due linee. Per utilizzare due righe, utilizzare il simbolo \\n.<\/p>\n\n
Lunghezza massima: 300 caratteri.<\/p>\n\n
- lat<\/strong> : latitudine<\/li>
- lng<\/strong> : longitudine<\/li><\/ul>\n\n
Invia Vcard<\/h2>\n\nvar to=\"put_your_mobile_number_here\"; \nvar vcard=`BEGIN:VCARD\nVERSION:3.0\nN:lastname;firstname\nFN:firstname lastname\nTEL;TYPE=CELL;waid=14000000001:14000000002\nNICKNAME:nickname\nBDAY:01.01.1987\nX-GENDER:M\nNOTE:note\nADR;TYPE=home\nADR;TYPE=work\nEND:VCARD`; \nconst response = await api.sendVcardMessage(to,vcard);\nconsole.log(response)<\/code><\/code><\/pre>\n\n- vcard<\/strong> : valore di testo vcard 3.0<\/li><\/ul>\n\n
Lunghezza massima: 4096 caratteri<\/p>\n\n
Ricevi messaggi<\/h2>\n\nvar page=1;\nvar limit=100;\nvar status=\"all\";\nvar sort=\"asc\";\nvar id=\"\";\nvar referenceId=\"\";\nvar from=\"\";\nvar to=\"\";\nvar ack=\"\";\nconst response = await api.getMessages(page,limit,status,sort,id,referenceId,from,to,ack);\nconsole.log(response)<\/code><\/code><\/pre>\n\n- pagina<\/strong> : numero di pagina di impaginazione<\/li>
- limite<\/strong> : numero di messaggi per richiesta. valore massimo: 100.<\/li>
- stato<\/strong> : stato dei messaggi [inviati, in coda, non inviati]
- inviato: riceve i messaggi inviati.<\/li>
- coda: riceve i messaggi dalla coda.<\/li>
- unsent: riceve i messaggi non inviati.<\/li>
- non valido: riceve messaggi non validi.<\/li>
- all: riceve tutti i messaggi.<\/li><\/ul><\/li>
- ordina<\/strong> :
- asc: ordina i messaggi per ID dal pi\u00f9 piccolo al pi\u00f9 grande.<\/li>
- desc: ordina i messaggi per ID dal pi\u00f9 grande al pi\u00f9 piccolo.<\/li><\/ul><\/li>
- id<\/strong> : filtra i messaggi per ID messaggio.<\/li>
- referenceId<\/strong> : filtra i messaggi in base al tuo ID di riferimento personalizzato.<\/li>
- da<\/strong> : filtra i messaggi per numero di mittente WhatsApp es. 14155552671@c.us .<\/li>
- a<\/strong> : filtrare i messaggi in base al numero del destinatario, ad esempio 14155552671@c.us o 14155552671-441234567890@g.us .<\/li>
- ack<\/strong> : filtra i messaggi in base allo stato di ack del messaggio [in attesa, server, dispositivo, letto, riprodotto].<\/li><\/ul>\n\n
Ottieni statistiche sui messaggi<\/h2>\n\nconst response = await api.getMessageStatistics();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nOttieni lo stato dell’istanza<\/h2>\n\nconst response = await api.getInstanceStatus();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nOttieni immagine QR di istanza<\/h2>\n\nconst response = await api.getInstanceQr();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nOttieni codice QR di istanza<\/h2>\n\nconst response = await api.getInstanceQrCode();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nOttieni informazioni sull’istanza<\/h2>\n\n
Ottieni informazioni sul telefono connesso: numero, nome, immagine, ecc.<\/p>\n\n
const response = await api.getInstanceMe();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nOttieni le impostazioni dell’istanza<\/h2>\n\nconst response = await api.getInstanceSettings();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nsendDelay : ritardo in secondi tra l’invio del messaggio, predefinito 1 secondo<\/p>\n\n
webhook_url: URL HTTP o https per la ricezione delle notifiche.<\/p>\n\n
webhook_message_ack : notifiche on\/off ack (messaggio consegnato e messaggio visualizzato) nei webhook.<\/p>\n\n
webhook_message_received: notifiche di attivazione\/disattivazione nei webhook alla ricezione del messaggio.<\/p>\n\n
webhook_message_create: attivazione\/disattivazione delle notifiche nei webhook quando il messaggio viene creato.<\/p>\n\n
webhook_message_download_media : attivato\/disattivato per ricevere documenti\/file multimediali ricevuti.<\/p>\n\n
Disconnessione dell’istanza<\/h2>\n\n
Esci da WhatsApp Web per ottenere un nuovo codice QR.<\/p>\n\n
const response = await api.sendInstanceLogout();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nRiavvio dell’istanza<\/h2>\n\n
Riavvia la tua istanza.<\/p>\n\n
const response = await api.sendInstanceRestart();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nAggiornamento delle impostazioni dell’istanza<\/h2>\n\nvar sendDelay=1;\nvar webhook_url=\"\";\nvar webhook_message_received=false;\nvar webhook_message_create=false;\nvar webhook_message_ack=false;\nvar webhook_message_download_media=false;\n\nconst response = await api.sendInstanceSettings(sendDelay,webhook_url,webhook_message_received,webhook_message_create,webhook_message_ack,webhook_message_download_media);\nconsole.log(response)<\/code><\/code><\/pre>\n\n- sendDelay<\/strong> : ritardo<\/a> in secondi tra l’invio del messaggio.<\/li>
- webhook_url<\/strong> : URL HTTP o https per la ricezione delle notifiche.<\/li>
- webhook_message_received<\/strong> : notifiche true\/false nei webhook quando il messaggio \u00e8 ricevuto.<\/li>
- webhook_message_create<\/strong> : notifiche true\/false nei webhook quando il messaggio viene creato.<\/li>
- webhook_message_ack<\/strong> : notifiche true\/false ack (messaggio consegnato e messaggio visualizzato) nei webhook.<\/li><\/ul>\n\n
Ottieni l’elenco delle chat<\/h2>\n\nconst response = await api.getChats();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nricevi l’ultimo messaggio dalla conversazione in chat<\/h2>\n\n- chatId<\/strong> : chatID per contatto o gruppo, ad esempio 14155552671@c.us o 14155552671-441234567890@g.us<\/li>
- limite<\/strong> : numero di messaggi per richiesta.<\/li><\/ul>\n\n
valore massimo: 1000.<\/p>\n\n
var chatId=\"14155552671@c.us\";\nvar limit=100;\nconst response = await api.getChatsMessages(chatId,limit);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nOttieni l’elenco dei contatti<\/h2>\n\nconst response = await api.getContacts();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nOttieni informazioni di contatto<\/h2>\n\n
chatId<\/strong> : chatID per il contatto es. 14155552671@c.us<\/p>\n\nvar chatId=\"14155552671@c.us\"; \nconst response = await api.getContact(chatId);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nOttiene tutti i contatti bloccati<\/h2>\n\nconst response = await api.getBlockedContacts();\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nbloccare il contatto da WhatsApp<\/h2>\n\n
chatId<\/strong> : chatID per il contatto es. 14155552671@c.us<\/p>\n\nvar chatId=\"14155552671@c.us\"; \nconst response = await api.blockContact(chatId);\nconsole.log(response)<\/code><\/pre>\n\n<\/a><\/h2>\n\nSblocca il contatto da WhatsApp<\/h2>\n\n
chatId<\/strong> : chatID per il contatto es. 14155552671@c.us<\/p>\n\nvar chatId=\"14155552671@c.us\"; \nconst response = await api.unblockContact(chatId);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nControlla se il numero \u00e8 un utente WhatsApp<\/h2>\n\n
chatId<\/strong> : chatID per il contatto es. 14155552671@c.us<\/p>\n\nvar chatId=\"14155552671@c.us\"; \nconst response = await api.checkContact(chatId);\nconsole.log(response)\n<\/code><\/code><\/pre>\n\nRicevi messaggi WhatsApp<\/h2>\n\n
puoi ricevere messaggi WhatsApp usando webhook, puoi vedere questo articolo<\/a> .<\/p>\n\nInfine<\/h2>\n\n
Puoi visitare il progetto su github<\/a><\/p>\n\nWhatsApp API Nodejs-sdk versione attuale: 1.0.1 su NPM<\/a> <\/p>\n\n<\/p>\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
introduzione In questo tutorial impareremo come utilizzare Ultramsg Nodejs-WhatsApp-sdk per utilizzare WhatsAppAPI con Nodejs Installazione … <\/p>\n