ارسال ایمیل ساده به تمامی کاربران اپلیکیشن

تعریف ایمیل ساده

این نوع ایمیل ارسال محتوا (عنوان، متن) به تمامی کاربران اپلیکیشن می‌باشد.

در این حالت با استفاده از شناسه اپلیکیشن (‍‍app_id) که در کنسول پوشه قابل دریافت می‌باشد می‌توانید به تمام کاربران اپلیکیشن‌تان ایمیل ارسال کنید.

مشاهده راهنمای دریافت شناسه اپلیکیشن

مخاطبان ایمیل

پیام شما برای آن دسته از کاربرانی که ایمیل برای آنها از طریق کتابخانه تخصیص یافته است، ارسال می‌شود.

برای دریافت اطلاعات بیشتر از چگونگی نحوه اختصاص ایمیل مخاطبان لطفا به راهنمای تخصیص شناسه شماره تماس در کتابخانه پوشه مراجعه کنید.

آدرس (url) ارسال ایمیل

برای ارسال ایمیل ساده می‌توانید از آدرس زیر که برای ارسال ایمیل به پلتفرم‌ اندروید می‌باشد استفاده کنید.

https://api.pushe.co/v2/messaging/email/

کلید‌های ارسال ایمیل ساده

برای ارسال یک ایمیل ساده حداقل کلیدهایی که می توان استفاده کرد تا یک ایمیل به صورت صحیح ساخته و ارسال شود به شکل زیر می‌باشد.

• app_ids: شناسه اپلیکیشن که از نوع رشته string می‌باشد.
  این فیلد اجباری است
• data: یک دیکشنری که مقادیر (محتوای) ایمیل را نگه می‌دارد.
  این فیلد اجباری است
  • subject: این فیلد بیانگر عنوان ایمیل می‌باشد و از نوع رشته string می‌باشد.
    این فیلد اجباری است
  • content: این فیلد بیانگر متن ایمیل می‌باشد و از نوع رشته string می‌باشد.
    این فیلد اجباری است
  • isHTML: در صورتی که بخواهید محتوای html ارسال کنید. باید مقدار این کلید را برابر true قرار دهید.

// minimum required keys
{
  "app_ids": ["YOUR_APP_ID"],
  "data": {
    "isHTML":false,
    "subject":"عنوان ایمیل",
    "content":"سلام خسته نباشید<br/><br/>این یک ایمیل تستی می‌یاشد."
  }
}

ارسال ایمیل با محتوای HTML

در صورتی که می‌خواهید محتوای ایمیل HTML باشد، کافیست کدهای HTML را در قالب string به عنوان مقدار کلید content قرار دهید. همچنین برای اینکار باید کلید isHTML را برابر مقدار true فرار دهید.`

مرتب‌ سازی متن پیام

برای قرار دادن new line در متن ایمیل کافیست از تگ <br/> همانند زیر استفاده کنید.

{
  "data":{
    "content":"سلام خسته نباشید<br/><br/>این یک ایمیل تستی می‌یاشد."
  }
}

کلید‌های مجاز در وب‌ سرویس ایمیل

برای مشاهده تمامی کلید‌های قابل استفاده در ارسال ایمیل به تمامی کلید های ایمیل مراجعه کنید.

نمونه کد ارسال ایمیل ساده

در نمونه کد های زیر حداقل کد مورد نیاز برای ارسال یک ایمیل ساده در زبان های مختلف با عنوان و متن نمایش داده شده. برای مشاهده تمامی کلید های قابل استفاده به بخش تمامی کلید های ایمیل مراجعه کنید.

CURL

• در این نمونه کد از cURL استفاده شده است که می‌توانیدتوسط sudo apt install curl آن را نصب کنید.

curl -X POST https://api.pushe.co/v2/messaging/email/ \
-H 'authorization: Token YOUR_TOKEN' \
-H 'content-type: application/json' \
-d '{
"app_ids": "YOUR_APP_ID", 
"data" :{"subject":"عنوان پیام", "content":"محتوای پیام"}
}'

NODE.JS

• برای اجرای این کد باید ابتدا پکیج axios را نصب کنید ‍npm install axios

const axios = require('axios');

const YOUR_TOKEN = 'put your token here ...';
const YOUR_APP_ID = 'put your app id here ...';

const url = `https://api.pushe.co/v2/messaging/email/`;

const options = {
    headers: {
        'Authorization': `Token ${YOUR_TOKEN}`,
        'Content-Type': 'application/json'
    }
};

const data = {
    app_ids: YOUR_APP_ID,
    data: {
        subject: 'عنوان پیام',
        content: 'متن پیام'
    }
};

axios.post(url, data, options)
    .then(resp => console.log(resp))
    .catch(err => console.error(err));

PYTHON

• برای اجرا نیاز به پایتون ورژن ۳.۶ و به بالا می‌باشد
• برای اجرای این کد باید ابتدا پکیج requests را نصب کنید. pip install requests

import requests
import json

YOUR_TOKEN = 'put your token here ...'
YOUR_APP_ID = 'put your app id here ...'

url = f'https://api.pushe.co/v2/messaging/email/'

headers = {
    'Authorization': f'Token {YOUR_TOKEN}',
    'Content-Type': 'application/json'
}

payload = json.dumps({
    'app_ids': YOUR_APP_ID,
    'data': {
        'subject': 'عنوان اعلان',
        'content': 'متن اعلان'
    }
})

r = requests.post(url, data=payload, headers=headers)

print(r.status_code)

PHP

$YOUR_TOKEN = 'put your token here ...';
$YOUR_APP_ID = 'put your app id here ...';

$ch = curl_init('https://api.pushe.co/v2/messaging/email/');

curl_setopt_array($ch, array(
    CURLOPT_POST  => 1,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => array(
        "Content-Type: application/json",
        "Authorization: Token " . $YOUR_TOKEN,
    ),
));

curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(array(
    'app_ids' => $YOUR_APP_ID,
    'data' => array(
        'subject' => 'عنوان پیام',
        'content' => 'متن پیام'
    )
)));

$result = curl_exec($ch);
 
curl_close($ch);

echo $result;

GO

package main

import (
    "fmt"
    "bytes"
    "io/ioutil"
    "encoding/json"
    "net/http"
)

const YOUR_TOKEN = "put your token here ..."
const YOUR_APP_ID = "put your app id here ..."

func main() {
    url := "https://api.pushe.co/v2/messaging/email/"

    payload := map[string]interface{}{
        "app_ids" : YOUR_APP_ID,
        "data": map[string]string{
            "subject": "عنوان اعلان",
            "content": "متن اعلان",
        },
    }

    jsonValue, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonValue))

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Token " + YOUR_TOKEN)

    client := &http.Client{}
    resp, err := client.Do(req)

    if err != nil {
        panic(err)
    }

    defer resp.Body.Close()

    fmt.Println("response Status:", resp.Status)
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println("response Body:", string(body))
}