> For the complete documentation index, see [llms.txt](https://developer.ecall-messaging.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.ecall-messaging.com/api-references/soap-webservice/getting-started.md).

# Getting started

Use the eCall SOAP webservice to send SMS, fax, and voice messages.

### Prerequisites

* You need an active **business account** with eCall.
* Webservice access must be enabled on your account.

### Message flow

Sending a message involves up to four steps:

1. Send the job to eCall.
2. Receive the result message.
3. Optionally receive a notification by SMS, pager, or email.
4. Optionally receive a recipient reply.

### Available methods

| Method           | Description                                    |
| ---------------- | ---------------------------------------------- |
| `SendSMSBasic`   | Send a text message to a mobile phone or pager |
| `SendFaxBasic`   | Send a fax without attachments                 |
| `SendFax`        | Send a fax with attachments                    |
| `SendVoiceBasic` | Send a voice message                           |
| `GetStateBasic`  | Query the status of a sent message             |

All methods are part of the **`eCall`** class.

### Endpoint

Use the following WSDL endpoint:

```
https://soap.ecall.ch/eCall.asmx
```

The endpoint exposes the WSDL and all available SOAP methods.

{% hint style="warning" %}
Parameters are case-sensitive. Use the exact capitalization.
{% endhint %}

### Transport and SOAP versions

The service is only available over **TLS 1.2**.

| Version  | Status               |
| -------- | -------------------- |
| SOAP 1.2 | Recommended          |
| SOAP 1.1 | Will be discontinued |

{% hint style="info" %}
Use SOAP 1.2 for all new integrations.
{% endhint %}

### .NET integration

In Visual Studio, add a web reference or connected service that points to:

```
https://soap.ecall.ch/eCall.asmx
```