> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar SMS

> POST /marketplace/messaging/send-sms — SMS transacional com template ou texto inline — pela API de mensageria da gu1 para comunicações com clientes.

Requer integração **SMS** ativa. Ver [Visão geral](/pt/api-reference/messaging/overview).

## Endpoint

```http theme={null}
POST https://api.gu1.ai/marketplace/messaging/send-sms
```

## Corpo

<ParamField body="to" type="string" required>
  Telefone (E.164 recomendado).
</ParamField>

<ParamField body="senderIndex" type="integer">
  Índice opcional do remetente Twilio na configuração.
</ParamField>

<ParamField body="templateParams" type="object">
  Substituições `{{variável}}`.
</ParamField>

**Template:** `templateId` (SMS). Sem `body`.

**Inline:** `body` obrigatório. Sem `templateId`. `templateParams` opcional no texto.

```json theme={null}
{
  "to": "+5511999999999",
  "body": "Seu código: {{token}}",
  "templateParams": { "token": "123456" }
}
```

Erros em **inglês** em `error` quando `success: false`.