mailersend-ruby 3.0.1 → 3.4.0

data/fixtures/whatsapp_inbound_messages/whatsapp_inbound_messages_list.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.mailersend.com/v1/whatsapp/inbound-messages?date_from=1790000000&date_to=1790086400&from=48600000001&limit=25&page=1&type%5B%5D=image&type%5B%5D=text&whatsapp_account_id=3enl6x27wmrxrl2v
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Authorization:
+      - "<AUTH>"
+      User-Agent:
+      - MailerSend-client-ruby/3.4.0
+      Accept:
+      - application/json
+      Connection:
+      - close
+      Host:
+      - api.mailersend.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 20 Oct 2026 08:00:00 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - close
+      Cache-Control:
+      - no-cache, private
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubDomains
+      Server:
+      - cloudflare
+    body:
+      encoding: UTF-8
+      string: '{"data":[{"id":"62f114f7165fe0d8db0288e2","whatsapp_account_id":"3enl6x27wmrxrl2v","from":"48600000001","to":"15550001234","type":"text","received_at":"2026-10-14T12:41:19.000000Z","meta":{"body":"Hello, I would like to check my order status."},"context":{"message_id":"wamid.HBgLMzcwNjMzMjI3OTcVAgARGBIwREE3N0EwN0EyNjhENjEwOEMA"}},{"id":"62f114c1165fe0d8db0288d9","whatsapp_account_id":"3enl6x27wmrxrl2v","from":"48600000001","to":"15550001234","type":"image","received_at":"2026-10-14T12:38:03.000000Z","meta":{"url":"https://app.mailersend.com/whatsapp/inbound-message-attachment/62f114c1165fe0d8db0288d9?account=3enl6x27wmrxrl2v&expires=1792022400&signature=...","status":"stored","mime_type":"image/jpeg","size":102400,"caption":"Here is the damaged item"}}],"links":{"first":"https://api.mailersend.com/v1/whatsapp/inbound-messages?page=1","last":null,"prev":null,"next":null},"meta":{"current_page":1,"current_page_url":"https://api.mailersend.com/v1/whatsapp/inbound-messages?page=1","from":1,"path":"https://api.mailersend.com/v1/whatsapp/inbound-messages","per_page":25,"to":2}}'
+  recorded_at: Tue, 20 Oct 2026 08:00:00 GMT
+recorded_with: VCR 6.3.1

data/fixtures/whatsapp_items/whatsapp_items_get.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.mailersend.com/v1/whatsapp/items/67f91abe2202f3705540234a
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Authorization:
+      - "<AUTH>"
+      User-Agent:
+      - MailerSend-client-ruby/3.4.0
+      Accept:
+      - application/json
+      Connection:
+      - close
+      Host:
+      - api.mailersend.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 20 Oct 2026 08:00:00 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - close
+      Cache-Control:
+      - no-cache, private
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubDomains
+      Server:
+      - cloudflare
+    body:
+      encoding: UTF-8
+      string: '{"data":{"id":"67f91abe2202f3705540234a","whatsapp_message_id":"67f91abd69f79df391e9d78d","whatsapp_account_id":"3enl6x27wmrxrl2v","from":"15550001234","to":"48600000001","status":"read","template_id":"23zxk54v6gjy6v7m","template_name":"Order confirmation","error_code":null,"error_message":null,"created_at":"2026-10-14T12:25:33.000000Z","recipient":{"id":"67f91abe2202f37055402301","phone_number":"48600000001","username":null,"status":"active","created_at":"2026-09-02T08:14:51.000000Z"},"activity":[{"type":"queued","created_at":"2026-10-14T12:25:33.000000Z"},{"type":"sent","created_at":"2026-10-14T12:25:34.000000Z"},{"type":"delivered","created_at":"2026-10-14T12:25:36.000000Z"},{"type":"read","created_at":"2026-10-14T12:31:02.000000Z"}]}}'
+  recorded_at: Tue, 20 Oct 2026 08:00:00 GMT
+recorded_with: VCR 6.3.1

data/fixtures/whatsapp_items/whatsapp_items_list.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.mailersend.com/v1/whatsapp/items?date_from=1791936000&date_to=1792022400&from=15550001234&limit=25&page=1&recipient=48600000002&status%5B%5D=failed&status%5B%5D=read&template_id=23zxk54v6gjy6v7m&whatsapp_account_id=3enl6x27wmrxrl2v&whatsapp_message_id=67f91abd69f79df391e9d78d
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Authorization:
+      - "<AUTH>"
+      User-Agent:
+      - MailerSend-client-ruby/3.4.0
+      Accept:
+      - application/json
+      Connection:
+      - close
+      Host:
+      - api.mailersend.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 20 Oct 2026 08:00:00 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - close
+      Cache-Control:
+      - no-cache, private
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubDomains
+      Server:
+      - cloudflare
+    body:
+      encoding: UTF-8
+      string: '{"data":[{"id":"67f91abe2202f3705540234b","whatsapp_message_id":"67f91abd69f79df391e9d78d","whatsapp_account_id":"3enl6x27wmrxrl2v","from":"15550001234","to":"48600000002","status":"failed","template_id":"23zxk54v6gjy6v7m","template_name":"Order confirmation","error_code":131026,"error_message":"Message undeliverable","created_at":"2026-10-14T12:25:33.000000Z"}],"links":{"first":"https://api.mailersend.com/v1/whatsapp/items?page=1","last":null,"prev":null,"next":null},"meta":{"current_page":1,"current_page_url":"https://api.mailersend.com/v1/whatsapp/items?page=1","from":1,"path":"https://api.mailersend.com/v1/whatsapp/items","per_page":25,"to":1}}'
+  recorded_at: Tue, 20 Oct 2026 08:00:00 GMT
+recorded_with: VCR 6.3.1

data/fixtures/whatsapp_messages/whatsapp_messages_get.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.mailersend.com/v1/whatsapp/messages/67f91abd69f79df391e9d78d
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Authorization:
+      - "<AUTH>"
+      User-Agent:
+      - MailerSend-client-ruby/3.4.0
+      Accept:
+      - application/json
+      Connection:
+      - close
+      Host:
+      - api.mailersend.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 20 Oct 2026 08:00:00 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - close
+      Cache-Control:
+      - no-cache, private
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubDomains
+      Server:
+      - cloudflare
+    body:
+      encoding: UTF-8
+      string: '{"data":{"id":"67f91abd69f79df391e9d78d","from":"15550001234","to":["48600000001","48600000002"],"whatsapp_account_id":"3enl6x27wmrxrl2v","template_id":"23zxk54v6gjy6v7m","created_at":"2026-10-14T12:25:33.000000Z","items":[{"id":"67f91abe2202f3705540234a","whatsapp_message_id":"67f91abd69f79df391e9d78d","whatsapp_account_id":"3enl6x27wmrxrl2v","from":"15550001234","to":"48600000001","status":"read","template_id":"23zxk54v6gjy6v7m","template_name":"Order confirmation","error_code":null,"error_message":null,"created_at":"2026-10-14T12:25:33.000000Z"},{"id":"67f91abe2202f3705540234b","whatsapp_message_id":"67f91abd69f79df391e9d78d","whatsapp_account_id":"3enl6x27wmrxrl2v","from":"15550001234","to":"48600000002","status":"failed","template_id":"23zxk54v6gjy6v7m","template_name":"Order confirmation","error_code":131026,"error_message":"Message undeliverable","created_at":"2026-10-14T12:25:33.000000Z"}]}}'
+  recorded_at: Tue, 20 Oct 2026 08:00:00 GMT
+recorded_with: VCR 6.3.1

data/fixtures/whatsapp_messages/whatsapp_messages_list.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.mailersend.com/v1/whatsapp/messages?date_from=1791936000&date_to=1792022400&from=15550001234&limit=25&page=1&template_id=23zxk54v6gjy6v7m&whatsapp_account_id=3enl6x27wmrxrl2v
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Authorization:
+      - "<AUTH>"
+      User-Agent:
+      - MailerSend-client-ruby/3.4.0
+      Accept:
+      - application/json
+      Connection:
+      - close
+      Host:
+      - api.mailersend.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 20 Oct 2026 08:00:00 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - close
+      Cache-Control:
+      - no-cache, private
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubDomains
+      Server:
+      - cloudflare
+    body:
+      encoding: UTF-8
+      string: '{"data":[{"id":"67f91abd69f79df391e9d78d","from":"15550001234","to":["48600000001","48600000002"],"whatsapp_account_id":"3enl6x27wmrxrl2v","template_id":"23zxk54v6gjy6v7m","created_at":"2026-10-14T12:25:33.000000Z"},{"id":"67f91a0c69f79df391e9d6a1","from":null,"to":["US.13491208655302741918"],"whatsapp_account_id":"p6nq4jyzkyv5x3zl","template_id":"6v7m23zxk54vgjy2","created_at":"2026-10-14T12:21:16.000000Z"}],"links":{"first":"https://api.mailersend.com/v1/whatsapp/messages?page=1","last":null,"prev":null,"next":null},"meta":{"current_page":1,"current_page_url":"https://api.mailersend.com/v1/whatsapp/messages?page=1","from":1,"path":"https://api.mailersend.com/v1/whatsapp/messages","per_page":25,"to":2}}'
+  recorded_at: Tue, 20 Oct 2026 08:00:00 GMT
+recorded_with: VCR 6.3.1

data/fixtures/whatsapp_recipient/whatsapp_recipient_get.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.mailersend.com/v1/whatsapp/recipients/67f91abe2202f37055402301
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Authorization:
+      - "<AUTH>"
+      User-Agent:
+      - MailerSend-client-ruby/3.4.0
+      Accept:
+      - application/json
+      Connection:
+      - close
+      Host:
+      - api.mailersend.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 20 Oct 2026 08:00:00 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - close
+      Cache-Control:
+      - no-cache, private
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubDomains
+      Server:
+      - cloudflare
+    body:
+      encoding: UTF-8
+      string: '{"data":{"id":"67f91abe2202f37055402301","phone_number":"48600000001","username":null,"status":"active","created_at":"2026-09-02T08:14:51.000000Z","items":[{"id":"67f91abe2202f3705540234a","whatsapp_message_id":"67f91abd69f79df391e9d78d","whatsapp_account_id":"3enl6x27wmrxrl2v","from":"15550001234","to":"48600000001","status":"read","template_id":"23zxk54v6gjy6v7m","template_name":"Order confirmation","error_code":null,"error_message":null,"created_at":"2026-10-14T12:25:33.000000Z"}]}}'
+  recorded_at: Tue, 20 Oct 2026 08:00:00 GMT
+recorded_with: VCR 6.3.1

data/fixtures/whatsapp_recipient/whatsapp_recipient_list.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.mailersend.com/v1/whatsapp/recipients?limit=25&page=1&phone_number=48600000001&status=active
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Authorization:
+      - "<AUTH>"
+      User-Agent:
+      - MailerSend-client-ruby/3.4.0
+      Accept:
+      - application/json
+      Connection:
+      - close
+      Host:
+      - api.mailersend.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 20 Oct 2026 08:00:00 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - close
+      Cache-Control:
+      - no-cache, private
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubDomains
+      Server:
+      - cloudflare
+    body:
+      encoding: UTF-8
+      string: '{"data":[{"id":"67f91abe2202f37055402301","phone_number":"48600000001","username":null,"status":"active","created_at":"2026-09-02T08:14:51.000000Z"}],"links":{"first":"https://api.mailersend.com/v1/whatsapp/recipients?page=1","last":null,"prev":null,"next":null},"meta":{"current_page":1,"current_page_url":"https://api.mailersend.com/v1/whatsapp/recipients?page=1","from":1,"path":"https://api.mailersend.com/v1/whatsapp/recipients","per_page":25,"to":1}}'
+  recorded_at: Tue, 20 Oct 2026 08:00:00 GMT
+recorded_with: VCR 6.3.1

data/fixtures/whatsapp_templates/whatsapp_templates_get.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.mailersend.com/v1/whatsapp/templates/23zxk54v6gjy6v7m
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Authorization:
+      - "<AUTH>"
+      User-Agent:
+      - MailerSend-client-ruby/3.4.0
+      Accept:
+      - application/json
+      Connection:
+      - close
+      Host:
+      - api.mailersend.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 20 Oct 2026 08:00:00 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - close
+      Cache-Control:
+      - no-cache, private
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubDomains
+      Server:
+      - cloudflare
+    body:
+      encoding: UTF-8
+      string: '{"data":{"id":"23zxk54v6gjy6v7m","whatsapp_account_id":"3enl6x27wmrxrl2v","name":"order_confirmation","readable_name":"Order confirmation","category":"UTILITY","language":"en_US","status":"approved","components":{"header":{"format":"TEXT","text":"{{1}}"},"body":{"text":"Hi {{1}}, your order is confirmed and will arrive on {{2}}."},"buttons":[{"type":"URL","text":"View order","url":"https://shop.example.com/{{1}}"}]},"created_at":"2026-10-14T12:25:33.000000Z","updated_at":"2026-10-14T12:41:07.000000Z"}}'
+  recorded_at: Tue, 20 Oct 2026 08:00:00 GMT
+recorded_with: VCR 6.3.1

data/fixtures/whatsapp_templates/whatsapp_templates_list.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.mailersend.com/v1/whatsapp/templates?category=UTILITY&language=en_US&limit=25&page=1&status=approved&whatsapp_account_id=3enl6x27wmrxrl2v
+    body:
+      encoding: ASCII-8BIT
+      string: ''
+    headers:
+      Authorization:
+      - "<AUTH>"
+      User-Agent:
+      - MailerSend-client-ruby/3.4.0
+      Accept:
+      - application/json
+      Connection:
+      - close
+      Host:
+      - api.mailersend.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Tue, 20 Oct 2026 08:00:00 GMT
+      Content-Type:
+      - application/json
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - close
+      Cache-Control:
+      - no-cache, private
+      Strict-Transport-Security:
+      - max-age=31536000; includeSubDomains
+      Server:
+      - cloudflare
+    body:
+      encoding: UTF-8
+      string: '{"data":[{"id":"23zxk54v6gjy6v7m","whatsapp_account_id":"3enl6x27wmrxrl2v","name":"order_confirmation","readable_name":"Order confirmation","category":"UTILITY","language":"en_US","status":"approved","components":{"header":{"format":"TEXT","text":"{{1}}"},"body":{"text":"Hi {{1}}, your order is confirmed and will arrive on {{2}}."},"buttons":[{"type":"URL","text":"View order","url":"https://shop.example.com/{{1}}"}]},"created_at":"2026-10-14T12:25:33.000000Z","updated_at":"2026-10-14T12:41:07.000000Z"},{"id":"p6nq4jyzkyv5x3zl","whatsapp_account_id":"3enl6x27wmrxrl2v","name":"delivery_update","readable_name":"Delivery update","category":"UTILITY","language":"en_US","status":"approved","components":{"header":null,"body":{"text":"Your parcel is out for delivery today."},"buttons":[{"type":"QUICK_REPLY","text":"Change delivery time","url":null}]},"created_at":"2026-10-13T09:02:18.000000Z","updated_at":"2026-10-13T09:02:18.000000Z"}],"links":{"first":"https://api.mailersend.com/v1/whatsapp/templates?page=1","last":null,"prev":null,"next":null},"meta":{"current_page":1,"current_page_url":"https://api.mailersend.com/v1/whatsapp/templates?page=1","from":1,"path":"https://api.mailersend.com/v1/whatsapp/templates","per_page":25,"to":2}}'
+  recorded_at: Tue, 20 Oct 2026 08:00:00 GMT
+recorded_with: VCR 6.3.1

data/flake.lock

@@ -0,0 +1,27 @@
+{
+  "nodes": {
+    "nixpkgs": {
+      "locked": {
+        "lastModified": 1789546076,
+        "narHash": "sha256-zVxLZiSnmaaPLwnhj7pwmqe3axBg/C6nG5JZsJMh2g4=",
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "b1b875982b17dabde9b4a37f3e229e74913e6db3",
+        "type": "github"
+      },
+      "original": {
+        "owner": "NixOS",
+        "ref": "nixos-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "root": {
+      "inputs": {
+        "nixpkgs": "nixpkgs"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}

data/flake.nix

@@ -0,0 +1,25 @@
+{
+  description = "MailerSend Ruby SDK environment";
+
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+  };
+
+  outputs = { self, nixpkgs }:
+    let
+      systems = [ "aarch64-darwin" "x86_64-darwin" "aarch64-linux" "x86_64-linux" ];
+      forEachSystem = f:
+        nixpkgs.lib.genAttrs systems (system: f system nixpkgs.legacyPackages.${system});
+    in
+    {
+      devShells = forEachSystem (system: pkgs: {
+        default = pkgs.mkShell {
+          packages = with pkgs; [
+            lefthook
+            gitleaks
+            git-secrets
+          ];
+        };
+      });
+    };
+}

data/lefthook.yml

@@ -0,0 +1,14 @@
+---
+pre-commit:
+  commands:
+    gitleaks:
+      run: gitleaks git --pre-commit --redact --staged --verbose --no-banner
+      fail_text: Staged changes contain a secret. Remove it; never commit and revert.
+    secrets:
+      run: |
+        git secrets --list | grep -q 'mssp' || {
+          git secrets --register-aws
+          git secrets --add 'mlsn\.[A-Za-z0-9._-]+'
+          git secrets --add 'mssp\.[A-Za-z0-9._-]+'
+        }
+        git secrets --scan {staged_files}

data/lib/mailersend/dmarc_monitoring/dmarc_monitoring.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Mailersend
+  # DMARC Monitoring endpoint from MailerSend API.
+  class DmarcMonitoring
+    attr_accessor :client, :monitor_id, :ip, :page, :limit
+
+    def initialize(client = Mailersend::Client.new)
+      @client = client
+    end
+
+    def list(page: nil, limit: nil)
+      hash = { 'page' => page, 'limit' => limit }
+      client.http.get(URI::HTTPS.build(host: MAILERSEND_API_BASE_HOST,
+                                       path: '/v1/dmarc-monitoring',
+                                       query: URI.encode_www_form(hash.compact)))
+    end
+
+    def create(domain_id:)
+      client.http.post("#{MAILERSEND_API_URL}/dmarc-monitoring",
+                       json: { 'domain_id' => domain_id })
+    end
+
+    def update(monitor_id:, wanted_dmarc_record:)
+      client.http.put("#{MAILERSEND_API_URL}/dmarc-monitoring/#{monitor_id}",
+                      json: { 'wanted_dmarc_record' => wanted_dmarc_record })
+    end
+
+    def delete(monitor_id:)
+      client.http.delete("#{MAILERSEND_API_URL}/dmarc-monitoring/#{monitor_id}")
+    end
+
+    def report(monitor_id:, page: nil, limit: nil)
+      hash = { 'page' => page, 'limit' => limit }
+      client.http.get(URI::HTTPS.build(host: MAILERSEND_API_BASE_HOST,
+                                       path: "/v1/dmarc-monitoring/#{monitor_id}/report",
+                                       query: URI.encode_www_form(hash.compact)))
+    end
+
+    def report_by_ip(monitor_id:, ip:, page: nil, limit: nil)
+      hash = { 'page' => page, 'limit' => limit }
+      client.http.get(URI::HTTPS.build(host: MAILERSEND_API_BASE_HOST,
+                                       path: "/v1/dmarc-monitoring/#{monitor_id}/report/#{ip}",
+                                       query: URI.encode_www_form(hash.compact)))
+    end
+
+    def report_sources(monitor_id:)
+      client.http.get("#{MAILERSEND_API_URL}/dmarc-monitoring/#{monitor_id}/report-sources")
+    end
+
+    def add_favorite(monitor_id:, ip:)
+      client.http.put("#{MAILERSEND_API_URL}/dmarc-monitoring/#{monitor_id}/favorite/#{ip}")
+    end
+
+    def remove_favorite(monitor_id:, ip:)
+      client.http.delete("#{MAILERSEND_API_URL}/dmarc-monitoring/#{monitor_id}/favorite/#{ip}")
+    end
+  end
+end

data/lib/mailersend/email/email.rb

@@ -16,6 +16,7 @@ module Mailersend
                   :reply_to,
                   :attachments,
                   :template_id,
+                  :language,
                   :tags,
                   :variables,
                   :personalization,
@@ -40,6 +41,7 @@ module Mailersend
       @headers = {}
       @list_unsubscribe = nil
       @send_at = send_at
+      @language = nil
     end
 
     def add_recipients(recipients)
@@ -86,6 +88,13 @@ module Mailersend
       @template_id = template_id
     end
 
+    # Language code (e.g. 'de', 'fr', 'pt-BR'). Only meaningful when a
+    # template_id is set; ignored for raw html/text sends. Max length 10.
+    # Supported: de, en, es, fr, it, lt, nl, pl, pt-BR
+    def add_language(language)
+      @language = language
+    end
+
     def add_tags(tags)
       @tags << tags
     end
@@ -131,6 +140,7 @@ module Mailersend
         'variables' => @variables,
         'personalization' => @personalization,
         'template_id' => @template_id,
+        'language' => @language,
         'attachments' => @attachments,
         'headers' => @headers,
         'list_unsubscribe' => @list_unsubscribe,

data/lib/mailersend/emails/emails.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Mailersend
+  # Emails endpoint from MailerSend API.
+  class Emails
+    attr_accessor :client,
+                  :domain_id,
+                  :date_from,
+                  :date_to,
+                  :limit,
+                  :page,
+                  :email_id
+
+    def initialize(client = Mailersend::Client.new)
+      @client = client
+    end
+
+    def list(domain_id:, date_from:, date_to:, limit: nil, page: nil, status: nil, interaction: nil,
+             recipient_email: nil, message_id: nil, template_id: nil, subject: nil, tag: nil)
+      hash = {
+        'domain_id' => domain_id,
+        'date_from' => date_from,
+        'date_to' => date_to,
+        'limit' => limit,
+        'page' => page,
+        # The API rejects a scalar status/interaction with 422, so they are always sent in array form.
+        'status[]' => status,
+        'interaction[]' => interaction,
+        'recipient_email' => recipient_email,
+        'message_id' => message_id,
+        'template_id' => template_id,
+        'subject' => subject,
+        'tag' => tag
+      }
+
+      client.http.get(URI::HTTPS.build(host: MAILERSEND_API_BASE_HOST, path: '/v1/emails',
+                                       query: URI.encode_www_form(hash.compact)))
+    end
+
+    def single(email_id:)
+      client.http.get("#{MAILERSEND_API_URL}/email/#{email_id}")
+    end
+  end
+end

data/lib/mailersend/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mailersend
-  VERSION = '3.0.1'
+  VERSION = '3.4.0'
 end

data/lib/mailersend/whatsapp/whatsapp.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Mailersend
+  # Send a WhatsApp message through MailerSend API
+  class WhatsApp
+    attr_accessor :client,
+                  :from,
+                  :to,
+                  :template_id,
+                  :personalization
+
+    def initialize(client = Mailersend::Client.new)
+      @client = client
+      @from = ''
+      @to = []
+      @template_id = ''
+      @personalization = []
+    end
+
+    def add_from(from)
+      @from = from
+    end
+
+    def add_to(to)
+      @to << to
+    end
+
+    def add_template_id(template_id)
+      @template_id = template_id
+    end
+
+    def add_personalization(personalization)
+      @personalization << personalization
+    end
+
+    def send
+      message = {
+        'from' => @from,
+        'to' => @to,
+        'template_id' => @template_id,
+        'personalization' => @personalization
+      }
+
+      client.http.post("#{MAILERSEND_API_URL}/whatsapp/send", json: message.delete_if { |_, value| value.to_s.strip == '' || value == [] || value == {} })
+    end
+  end
+end