EvolutionAPI.Client 0.0.1-preview.5

EvolutionAPI Client

Este repositório fornece um exemplo de como se integrar à EvolutionAPI usando EvolutionAPI.Client.

Requisitos

• .NET 8 ou superior
• Pacote EvolutionAPI.Client

Funcionalidades

• ✅ Gerenciamento de Instância
• ✅ Gerenciamento de Webhook
• ✅ Envio de mensagens de texto
• ✅ Envio de mensagens de mídia por URL (imagem, documento, vídeo e áudio)
• ✅ Envio de localização
• ✅ Webhook Response Model

Instalação

Adicione a dependência do cliente EvolutionAPI ao seu projeto:

 dotnet add package EvolutionAPI.Client

Configuração

1. Configuração de dependências

Antes de utilizar a API, registre o serviço na injeção de dependências:

Opção 1

using EvolutionAPI.Client;

var apiUrl = "SUA_URL_API";
var apiKey = "SUA_API_KEY";

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddEvolutionApi(apiUrl, apiKey);

var app = builder.Build();

Opção 2

using EvolutionAPI.Client;

var apiUrl = "SUA_URL_API";
var apiKey = "SUA_API_KEY";

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddEvolutionApi(config =>
{
    config.ApiUrl = apiUrl;
    config.ApiKey = apiKey;
});

var app = builder.Build();

2. Injetando a IEvolutionClient

using EvolutionAPI.Client;

public class HomeController : Controller
{
    private readonly IEvolutionClient client;

    public HomeController(IEvolutionClient client)
    {
        this.client = client;
    }

    [HttpGet]
    public async Task<IActionResult> Index()
    {
        return View();
    }
}

Funcionalidades

Criar uma Instância

using EvolutionAPI.Client.Models.Requests.Instance;

var request = new CreateInstanceRequest()
{
    InstanceName = "TESTE-API",
    //Token = "",
    //Number = "",
    //QRCode = false,
    Integration = IntegrationType.WHATSAPP_BAILEYS
};

var response = await client.Instance.Create(request);

Configurar Webhook

using EvolutionAPI.Client.Models.Requests.Webhook;

var request = new CreateWebhookRequest()
{
    Webhook = new()
    {
        Enabled = true,
        Url = "www.domain.com",
        //Headers = new Dictionary<string, string>()
        //{
        //    { "Autorization", "Bearer TOKEN" },
        //    { "Content-Type", "application/json" }
        //},
        //ByEvents = false,
        //Base64 = false,
        Events = [WebhookEvent.MESSAGES_UPSERT, WebhookEvent.SEND_MESSAGE]
    }
};

var response = await client.Webhook.Create(request, "TESTE-API");

Enviar mensagem Texto

using EvolutionAPI.Client.Models.Requests.Message;

var request = new SendTextRequest()
{
    Number = "5511999999999",
    Text = "Teste de mensagem",
    //Delay = 1000
};

var response = await client.Message.SendText(request, "TESTE-API");

Enviar mensagem Mídia URL

using EvolutionAPI.Client.Models.Requests.Message;

var request = new SendMediaUrlRequest()
{
    Number = "5511999999999",
    MediaType = MediaType.IMAGE,
    //MimeType = "image/png",
    //Caption = "Teste de imagem",
    Media = "https://api.nuget.org/v3-flatcontainer/evolutionapi.client/0.0.1-preview.1/icon",
    //FileName = "imagem.png",
    //Delay = 1000
};

var response = await client.Message.SendMediaUrl(request, "TESTE-API");

Enviar localização

using EvolutionAPI.Client.Models.Requests.Message;

var request = new SendLocationRequest()
{
    Number = "5511999999999",
    //Name = "Curitiba, Paraná, Brasil",
    //Address = "Rua XV de Novembro, Centro, Curitiba - PR, 80020-310",
    Latitude = -25.4284,
    Longitude = -49.2733,
    //Delay = 1000
};

var response = await client.Message.SendLocation(request, "TESTE-API");

Observações

• Certifique-se de que a Evolution API está acessível.
• Substitua SUA_URL_API e SUA_API_KEY pelos valores reais.
• A InstanceName deve ser única para cada cliente.

Suporte

Caso tenha dúvidas ou precise de suporte, consulte a documentação oficial da EvolutionAPI ou entre em contato com o suporte da plataforma.