Créer un Sender

Cette méthode permet d'envoyer une nouvelle demande à l'expéditeur.

Certains pays exigent que vous vous enregistriez en tant qu'expéditeur avant de pouvoir envoyer un SMS avec un expéditeur personnalisé. Voici la liste des pays concernés :

Chaque demande d'enregistrement est traitée par notre service client.

POST

/sender

Paramètres du body

sender requis	Votre sender
country_code requis	Pays où vous utiliserez ce sender (ISO 3166-1 alpha-2)
company_name requis	Votre entreprise
general_contact requis	Votre adresse email
phone_number requis	Votre numéro de téléphone
vat	Votre numéro de TVA
fiscal_code	Votre code fiscal
complete_address	L'adresse de votre entreprise
escalation_contact	Votre adresse PEC
website	Votre site internet
type_of_service	Votre activité professionnelle
type_of_sms	Le type d'envoi (`alert` ou `marketing`)

Exemples


POST /sender HTTP/1.1
Host: api.smsfactor.com
Authorization: Bearer your.token
Accept: application/json

{
    "sender": {
    "sender": "MySender",
    "country_code": "FR",
    "company_name": "My company",
    "vat": "FR123456789",
    "fiscal_code": "FR123456789",
    "complete_address": "1 rue de la paix",
    "escalation_contact": "email@domain.com",
    "general_contact": "email@domain.com",
    "website": "www.domain.com",
    "type_of_service": "services",
    "phone_number": "33612345678",
    "message_type": "alert"
    }
}

Format de la réponse


{
    "status": 1,
    "message": "OK",
    "sender": {
        "id": 7,
        "sender": "MySender",
        "country_code": "FR",
        "status": "0",                    //Status of the sender request
        "company_name": "My company",
        "vat_number": "FR123456789",
        "fiscal_code": "FR123456789",
        "full_address": "1 rue de la paix",
        "escalation_contact": "email@domain.com",
        "general_contact": "email@domain.com",
        "website": "www.domain.com",
        "type_of_service": "services",
        "phone_number": "33612345678",
        "created_at": "2024-07-27 07:59:44",
        "message_type": "alert"
    }
}


<response>
<status>1</status>
<message>OK</message>
<sender>
    <id>7</id>
    <sender>MySender</sender>
    <country_code>FR</country_code>
    <status>0</status>
    <company_name>My company</company_name>
    <vat_number>FR123456789</vat_number>
    <fiscal_code>FR123456789</fiscal_code>
    <full_address>1 rue de la paix</full_address>
    <escalation_contact>email@domain.com</escalation_contact>
    <general_contact>email@domain.com</general_contact>
    <website>www.domain.com</website>
    <type_of_service>services</type_of_service>
    <phone_number>33612345678</phone_number>
    <created_at>2024-07-27 07:59:44</created_at>
    <message_type>alert</message_type>
</sender>
</response>

Statuts

Code	Value
-1	Demande rejetée
0	Demande en cours
1	Demande envoyé aux opérateurs
2	Demande validée
3	Demande annulée