---
title: "Pošiljanje e-pošte | Tajo"
description: "Pošiljajte transakcijsko e-pošto prek API-ja Brevo"
url: https://tajo.io/sl/docs/email-messaging/transactional-email/send-email/
markdown: https://tajo.io/sl/docs/email-messaging/transactional-email/send-email.md
lang: sl-SI
author: "Set Noa"
author_url: https://tajo.io/sl/set-noa/
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# Pošiljanje e-pošte

[Set Noa](https://tajo.io/sl/set-noa/)

Pošiljajte posamezna transakcijska e-poštna sporočila prek končne točke `/v3/smtp/email`.

## Končna točka

```http
POST /v3/smtp/email
```

## Telo zahteve

### Osnovno sporočilo

```json
{
  "sender": {
    "name": "Your App",
    "email": "noreply@yourapp.com"
  },
  "to": [
    {
      "email": "user@example.com",
      "name": "John Doe"
    }
  ],
  "subject": "Welcome to our service!",
  "htmlContent": "<html><body><h1>Welcome!</h1><p>Thank you for signing up.</p></body></html>"
}
```

### Napredno sporočilo

```json
{
  "sender": {
    "name": "Your App",
    "email": "noreply@yourapp.com"
  },
  "to": [
    {
      "email": "user@example.com",
      "name": "John Doe"
    }
  ],
  "cc": [
    {
      "email": "cc@example.com",
      "name": "CC User"
    }
  ],
  "bcc": [
    {
      "email": "bcc@example.com"
    }
  ],
  "subject": "Order Confirmation #{{order_id}}",
  "htmlContent": "<html><body><h1>Order Confirmed</h1><p>Your order {{order_id}} has been confirmed.</p></body></html>",
  "textContent": "Your order {{order_id}} has been confirmed.",
  "params": {
    "order_id": "12345"
  },
  "tags": ["transactional", "order-confirmation"],
  "headers": {
    "X-Custom-Header": "custom-value"
  }
}
```

## Primeri kode

### JavaScript/Node.js

```javascript
const brevo = require('@getbrevo/brevo');

const apiInstance = new brevo.TransactionalEmailsApi();
apiInstance.setApiKey(brevo.TransactionalEmailsApiApiKeys.apiKey, process.env.BREVO_API_KEY);

const sendEmail = async () => {
  const sendSmtpEmail = new brevo.SendSmtpEmail();

  sendSmtpEmail.subject = "Welcome to our service!";
  sendSmtpEmail.htmlContent = "<html><body><h1>Welcome!</h1></body></html>";
  sendSmtpEmail.sender = { name: "Your App", email: "noreply@yourapp.com" };
  sendSmtpEmail.to = [{ email: "user@example.com", name: "John Doe" }];

  try {
    const result = await apiInstance.sendTransacEmail(sendSmtpEmail);
    console.log('Email sent:', result);
    return result;
  } catch (error) {
    console.error('Error sending email:', error);
    throw error;
  }
};
```

### Python

```python
import sib_api_v3_sdk
from sib_api_v3_sdk.rest import ApiException

configuration = sib_api_v3_sdk.Configuration()
configuration.api_key['api-key'] = 'YOUR_API_KEY'

api_instance = sib_api_v3_sdk.TransactionalEmailsApi(sib_api_v3_sdk.ApiClient(configuration))

send_smtp_email = sib_api_v3_sdk.SendSmtpEmail(
    to=[{"email": "user@example.com", "name": "John Doe"}],
    sender={"name": "Your App", "email": "noreply@yourapp.com"},
    subject="Welcome to our service!",
    html_content="<html><body><h1>Welcome!</h1></body></html>"
)

try:
    api_response = api_instance.send_transac_email(send_smtp_email)
    print(api_response)
except ApiException as e:
    print("Exception when calling TransactionalEmailsApi->send_transac_email: %s\n" % e)
```

### cURL

```bash
curl -X POST "https://api.brevo.com/v3/smtp/email" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_API_KEY" \
  -d '{
    "sender": {
      "name": "Your App",
      "email": "noreply@yourapp.com"
    },
    "to": [
      {
        "email": "user@example.com",
        "name": "John Doe"
      }
    ],
    "subject": "Welcome to our service!",
    "htmlContent": "<html><body><h1>Welcome!</h1></body></html>"
  }'
```

## Odgovor

### Uspešen odgovor (201 Created)

```json
{
  "messageId": "<202301151234.12345@smtp-relay.mailin.fr>"
}
```

### Odgovori z napako

**Neveljaven ključ API (401)**

```json
{
  "code": "unauthorized",
  "message": "Invalid API key provided"
}
```

**Neveljavna oblika e-poštnega naslova (400)**

```json
{
  "code": "invalid_parameter",
  "message": "Invalid email format in 'to' field"
}
```

**Presežena omejitev števila zahtev (429)**

```json
{
  "code": "too_many_requests",
  "message": "Rate limit exceeded"
}
```

## Parametri

### Obvezni parametri

| Parameter | Tip | Opis |
| --- | --- | --- |
| `sender` | object | Podatki o pošiljatelju |
| `to` | array | Polje objektov s prejemniki |
| `subject` | string | Zadeva e-poštnega sporočila |

### Neobvezni parametri

| Parameter | Tip | Opis |
| --- | --- | --- |
| `htmlContent` | string | Vsebina sporočila v obliki HTML |
| `textContent` | string | Besedilna vsebina sporočila |
| `cc` | array | Prejemniki kopije |
| `bcc` | array | Prejemniki skrite kopije |
| `replyTo` | object | Naslov za odgovor |
| `attachments` | array | Priponke |
| `params` | object | Parametri predloge |
| `tags` | array | Oznake sporočila za sledenje |
| `headers` | object | Glave po meri |

## Spremenljivke predloge

V zadevi in vsebini uporabite spremenljivke predloge:

```json
{
  "subject": "Welcome {{firstName}}!",
  "htmlContent": "<h1>Hello {{firstName}} {{lastName}}</h1>",
  "params": {
    "firstName": "John",
    "lastName": "Doe"
  }
}
```

## Priponke

Sporočilu priložite datoteke:

```json
{
  "attachments": [
    {
      "content": "base64_encoded_content",
      "name": "invoice.pdf"
    },
    {
      "url": "https://example.com/document.pdf",
      "name": "document.pdf"
    }
  ]
}
```

## Dobre prakse

1. **Vedno vključite vsebino v obliki HTML in besedilno vsebino** za boljšo dostavljivost
2. **Uporabljajte spremenljivke predloge** namesto lepljenja vsebine
3. **Navedite pravilne podatke o pošiljatelju**, da se izognete filtrom za neželeno pošto
4. **Dodajte oznake** za sledenje in analitiko
5. **Preverite e-poštne naslove** pred pošiljanjem
6. **Napake obravnavajte premišljeno**, z logiko za ponovne poskuse

## Omejitve števila zahtev

- **Omejitev API**: na splošni ravni, ki jo dobi vsak paket, ta končna točka dovoljuje 1.000 zahtev na sekundo in 3.600.000 na uro. Napredna raven (Professional in Enterprise) dovoljuje 2.000 na sekundo, razširjena raven (Enterprise) pa 6.000.
- **Obseg pošiljanja**: koliko e-poštnih sporočil lahko pošljete, določa vaš paket Brevo, ločeno od omejitve števila zahtev.

Oglejte si [Omejitve števila zahtev](https://tajo.io/sl/docs/rate-limits/) in [stran Brevo z omejitvami](https://developers.brevo.com/docs/api-limits).

## Sledenje

Sporočilom, poslanim prek te končne točke, se samodejno sledi za:

- stanje dostave
- stopnjo odprtja
- sledenje klikom
- obravnavo zavrnitev

Podrobno analitiko si oglejte na nadzorni plošči Brevo v razdelku **Statistics** → **Transactional**.

## Sorodne končne točke

- Predloge e-pošte
- Priponke
- [Statistika e-pošte](https://tajo.io/sl/docs/analytics-reporting/)