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-06-15 04:42:12",
        "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-06-15 04:42:12</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