Ir para o conteúdo

SendContact#

O método é destinado ao envio de uma mensagem com um contato. É criado um cartão de visita do contato e enviado para o chat. A mensagem será adicionada à fila para envio. A mensagem para envio é armazenada na fila por 24 horas e será enviada assim que o telefone for autorizado. A velocidade de envio das mensagens da fila é regulada pelo parâmetro Intervalo de envio de mensagens.

Solicitação#

Para enviar uma mensagem com um contato, você precisa executar uma solicitação no seguinte endereço:

POST https://api.green-api.com/waInstance{{idInstance}}/sendContact/{{apiTokenInstance}} 

Para obter os parâmetros de solicitação `idInstance` e `apiTokenInstance`, consulte a seção [Antes de começar](../../before-start.md#parameters).

### Parâmetros da solicitação {#request-parameters}

Parâmetro | Tipo | Obrigatório | Descrição
----- | ----- | ----- | -----
`chatId` | **string** | Sim | [Identificador do chat](../chat-id.md)
`contact` | **object** | Sim | Objeto sobre o contato
`quotedMessageId` | **string** | Não | Identificador da mensagem citada; se especificado, a mensagem será enviada citando a mensagem do chat especificada

Parâmetros do objeto `contact`:

Parâmetro | Tipo | Obrigatório | Descrição
----- | ----- | ----- | -----
`phoneContact ` | **integer** | Sim | número de telefone do contato no formato internacional (sem +), 11 ou 12 dígitos
`firstName` | **string** | Se `middleName`, `lastName`, `company` não forem especificados | Nome do contato
`middleName` | **string** | Se `firstName`, `lastName`, `company` não forem especificados | Sobrenome do meio do contato
`lastName` | **string** | Se `middleName`, `firstName`, `company` não forem especificados | Sobrenome do contato
`company` | **string** | Se `middleName`, `lastName`, `firstName` não forem especificados | Nome da empresa do contato

### Exemplo de corpo de solicitação {#request-example-body}

Envio de mensagem para chat privado:

```json
{
    "chatId": "11001234567@c.us",
    "contact": {
        "phoneContact": 79001234568,
        "firstName": "Artur",
        "middleName": "Pedro",
        "lastName": "Silva",
        "company": "Bicicleta S/A"
    }
}

Отправка сообщения в групповой чат: 

{
    "chatId": "120363043968066561@g.us",
    "contact": {
        "phoneContact": 79001234568,
        "firstName": "Артем",
        "middleName": "Петрович",
        "lastName": "Евпаторийский",
        "company": "Велосипед"
    }
}

Отправка сообщения с цитированием: 

{
    "chatId": "11001234567@c.us",
    "quotedMessageId": "361B0E63F2FDF95903B6A9C9A102F34B",
    "contact": {
        "phoneContact": 79001234568,
        "firstName": "Carlos",
        "middleName": "Petrovich",
        "lastName": "Silva",
        "company": "Bicicleta"
    }
}

Resposta#

Campos de resposta#

Campo Tipo Descrição
idMessage string Identificador da mensagem enviada

Exemplo do corpo da resposta#

{
    "idMessage": "3EB0C767D097B7C7C030"
}

Erros SendContact#

Veja a lista de erros comuns a todos os métodos na seção Erros padrão

Exemplo de código em Python#

import requests

url = "https://api.green-api.com/waInstance{{idInstance}}/sendContact/{{apiTokenInstance}}"

payload = "{\r\n\t\"chatId\": \"11001234567@c.us\",\r\n\t\"contact\": {\r\n\t\t\"phoneContact\": 79001234568,\r\n    \t\"firstName\": \"Carlos\",\r\n\t\t\"middleName\": \"Roberto\",\r\n\t\t\"lastName\": \"Silveira\",\r\n\t\t\"company\": \"Bicicleta\"\r\n\t}\r\n}\r\n"
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.text.encode('utf8'))