Evento de envio do formulário de contacto — envie-o quando um visitante da loja preencher o formulário de contacto. Os parâmetros do pedido, a escolha da notificação e o formato da resposta estão descritos na [visão geral da E-shop API](https://www.bulkgate.com/pt/documentacao/eshop-api/eshop-api-visao-geral/).

## URL da API

URL utilizado para enviar pedidos HTTP:

```url
https://portal.bulkgate.com/api/1.0/eshop/contact/form
```

> [!NOTE]
> Se o pedido não chegar ao destino, repita-o no [servidor de reserva](https://www.bulkgate.com/pt/documentacao/administracao-da-api/servidor-de-reserva/) `backup1.bulkgate.com`.

## Métodos HTTP suportados

- `POST` - `application/json`

```http
POST /api/1.0/eshop/contact/form HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
```

## Notificação

O portal utiliza a notificação do evento `contact_form`. O formulário não tem variáveis fixas — envie os campos do formulário com nomes próprios e utilize-os no modelo (`<nome>`). O texto da mensagem do visitante pode ser enviado, por exemplo, em `customer_message`.

## Exemplo de pedido

```http-json
POST /api/1.0/eshop/contact/form HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
  "application_id": 451,
  "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
  "language": "pt",
  "variables": {
    "customer_name": "João Silva",
    "customer_email": "joao.silva@example.com",
    "customer_mobile": "777777777",
    "customer_country_id": "cz",
    "customer_message": "Bom dia, quando voltarão a ter o tamanho M em stock?"
  }
}
```

## Resposta

```json
{
    "data": {
        "admin": [
            {
                "status": "accepted",
                "message_id": "tmpde1bcd4b1d1",
                "part_id": ["tmpde1bcd4b1d1"],
                "number": "420777777777",
                "channel": "sms"
            }
        ]
    }
}
```

O significado das chaves `customer` e `admin`, os erros no envio e os tipos de erros encontram-se na [visão geral da E-shop API](https://www.bulkgate.com/pt/documentacao/eshop-api/eshop-api-visao-geral/).
